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ABSTRACT 

The Real Time Operating System (RTOS) for the DGC family computers 
consists primarily of a small, core resident, general -purpose multi- 
task monitor designed to control a wide variety of real time input/output 
devices. User programs are relieved from the details of I/O timing, 
data buffering, priority handling, and task scheduling. In addition, tasks 
are provided with a parallel processing capability plus inter-task commun- 
ication and synchronization facilities. 

Communication with the monitor takes place through a small set of system 
and task commands. Calling sequences and mnemonics are identical to 
those in Data General's Real Time Disk Operating System (RDOS). This 
allows software development and debugging to be carried out on an RDOS 
system for later use in a core -only RTOS system. Moreover, since 
RTOS is highly modular, additional device handlers can be added to an 
RTOS system with relative ease. 
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CHAPTER 1 
INTRODUCTION TO RTOS 

The Real Time Operating System (RTOS) for the DGC family computers consists 
primarily of a small, general purpose multi-task monitor designed to control a 
wide variety of real time input/output devices. RTOS is entirely core -resident, 
highly modular and largely reentrant, and allows for the straightforward addition 
of special device handlers. Moreover, RTOS, revision 3. 00 is a compatible subset 
of RDOS revision 3.00, Data General's Real Time Disk Operating System. 

User programs are relieved from the details of I/O timing, data buffering, 
priority handling, and task scheduling. In addition, users are provided with a 
parallel processing capability plus inter -task communication and synchronization 
facilities. Communication with the RTOS monitor takes place through a small 
set of RTOS system and task calls. 

A task is the basic logical unit controlled by RTOS. Tasks are created by means of 
one of the RTOS task calls, and having been created, a task may be terminated 
at any time. A large number of common processing situations lend themselves 
admirably to this sort of operational control philosophy. Examples of these 
processing situations include the reading or writing of a block of data while simul- 
taneously performing arithmetic computations, listening for input from several 
devices at the same time, shared device use by multiple tasks, sophisticated 
communications problems, etc. 

RTOS TASK CONCEPTS 

A task is a logically complete execution path through user address space which 
demands the use of system resources. Many tasks may be assigned to operate 
asynchronously in a single reentrant sequence of instructions, and each task may 
be assigned a unique priority and identification number. 

Due to the serial nature of a computer, tasks which appear to be executing their 
operations in parallel are in actuality executing these operations in short, serial 
segments. It is necessary then for RTOS to maintain certain status information 
(primarily active registers) concerning all tasks which are not currently in control 
of the Central Processing Unit (CPU). 

This information is retained in an information structure called the Task Control 
Block (TCB). The maximum number of TCBs is defined at the time of system 
generation. 
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Task States 

In a multitask environment, tasks may exist in either of two states. Tasks are 
either ready for execution or they are suspended. The highest priority ready task 
will be given control of the CPU and the other ready tasks await their turn in a 
queue organized by priority. 

Suspended tasks are tasks which were once ready. A task may become suspended 
for one or more of the following reasons: 

1. It has been suspended by . SUSP, . ASUSP, or . TIDS. 

2. It has suspended itself for a specified period by . DELAY. 

3. It is waiting for a message from another task, . REC . 

4. It has issued a message -and -wait call, . XMTW. 

5. It is awaiting the completion of a . SYSTM call. 

Just as a number of different events may suspend a ready task, several events 
can cause a suspended task to be readied; 

1. The completion of a . SYSTM call (such as a request for I/O or the 
expiration of a time delay). 

2. The posting of a message for a suspended task awaiting its receipt, 
or the awaited receipt of a transmitted message. 

3. The readying of a task by . ARDY or . TIDR task calls. 

If a. task is suspended by both a task suspend call and by some other event, the 
call must be readied both by an . ARDY (or . TIDR ) call and by whatever other 
event is required to ready the task. 

Suspended and ready tasks are each connected in queues. Tasks may be deleted 
from either the ready or the suspended queues, either separately (. ABORT or 
. TIDK) or as a priority class (. AKILL). Tasks which have been deleted add their 
empty TCBs to an inactive chain of free TCBs. When a task is initiated (. TASK), a 
TCB is taken from the free chain, the state of the calling task is saved in its own 
TCB, and both tasks are entered into the ready queue as ready tasks. The . TASK 
command must be used to initiate a multitask environment. 

If all tasks are killed, the effect is to place the entire system in the idle state 
and to close all channels, with control passing to the task scheduler. The system 
remains capable of servicing interrupts. 
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Task Identification Numbers 

When a task is created, it may be created both with a unique identification number 
(I. D. ) from 1 to 377 and at a specified priority level (from to 377 ). The 
identification number allows tasks to be readied, suspended, or killed on a 
selective basis. If unique I. D. 's are not desired, tasks may ill be created with 
I. D. 's of 0. Tasks may exist at priority levels of (the highest) through 377 
(the lowest priority). Moreover, several or all tasks may exist at the same 
priority level. The task scheduler always allocates CPU control to the highest 
priority ready tasK; ready tasks within the same priority level receive CPU control 
on a round-robin basis. 

Task Synchronization and Communication 

RTOS permits tasks to communicate with one another by sending and receiving 
one-word non-zero messages. A one-word message is sent to a task in an agreed- 
upon location in user address space. User address space is understood to include 
all locations from address 16 through NMAX-1 inclusively. 

The task sending a message may either return to the Task Scheduler immediately 
(. XMT) or it may wait (. XMTW) and place itself in the suspended state until the 
receiving task has issued a receive request (. REC) and has received the message. 
Receipt of the message includes the resetting of the contents of the message address 
to all zeroes. Upon receipt of the message, the recipient reverts to the ready 
state. 

System and Task Call Formats 

Calls to the RTOS monitor can be separated into two categories: system calls 
and task calls. System calls generally perform system I/O. Task calls perform 
user task management functions. 

System command words and the mnemonic . SYSTM that must precede each command 
word are recognized as legal mnemonics by both the RDOS and stand-alone extended 
assemblers. Appearance of the mnemonic . SYSTM in a program results in the 
assembling of a JSR @ 17 instruction. The specific system command word is assem- 
bled as the word following the mnemonic . SYSTM. 

Once system action is complete and the task receives CPU control in priority fashion, 
normal return is made to the second instruction after the system command word. If 
an exceptional condition is detected, return is made to the first instruction following 
the system command word. 
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System and Task Call Formats (Continued) 

The general form of a system call description is: 

AC - required input to the call 

. SYSTM 
command 

error return (error code in AC2) 

normal return ( all AC's except AC3are restored unless output 
is returned via accumulator) 

AC - output from the call 

n 

There are 2 basic command word formats: 

command n and command 

where n is a number from to 76 representing an I/O channel number. The 
maximum number of channels, like the maximum number of tasks, is defined at 
the time of system generation. Any system command requiring a channel number 
n need not specify this number in the command word. Instead, by specifying 
n to be octal 77, the system will use the number passed in AC2 as the channel 
number. 

When no I/O is needed in command execution, the command word appears alone in 
the instruction. If the command requires arguments, these are passed in the 
accumulators. 

Status of the accumulators upon return from the system call is as follows. If the 
system returns no information as a result of the call, the carry bit and all 
accumulators except AC3 will be preserved. 

Ac]2 is used when an exceptional return is made to return a numeric error code. 
Error codes are listed by number in the RTOS parameter listing, and the applicable 
codes are listed for each command. 
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System and Task Call Formats (Continued) 

AC3 is destroyed by both . SYSTM and task calls, since they are each equivalent 
to JSR instructions. On return from the system however, AC3 is loaded with the 
contents of memory location 016. This location is defined as a permanent symbol 
by the assembler and has the name User Stack Pointer (USP). A convenient 
method of saving AC3 is to store it in location 016 before issuing either . SYSTM 
or task calls. 

The general form of a task call in a program is: 



requireu input to tue c<±n 



command 

error return (error code in AC2) 

normal return ( all AC'S except AC3 are restored unless 
output is returned via accumulators) 

AC - output from the call 

Users of task calls are cautioned to reference all task call commands whose 
operations are required within a program by their call names in an . EXTN state- 
ment in that program. Only those calls which are so referenced will have the 
appropriate task call processing modules loaded by the relocatable loader. 

The significant differences between a . SYSTM call and a task call are as follows: 

1. Task calls are not preceded by the . SYSTM mnemonic. 

2. Not all task calls have error returns. Those which do not 
have an error return do not reserve an error return location. 
All system calls reserve error return locations even if there 
is no error return possible. 

DEVICE SUPPORT UNDER RTOS 



I/O devices are given special reserved names which often begin with the character 
$. TV following list gives the names of devices supported under RTOS and their 
reserved names: 

$CDR - Card reader. 

$CDR1 - Second card reader. 

CTn - Data General cassette unit n (n can be from to 7). 

DKO - Data General fixed head NOVADISC 
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DEVICE SUPPORT UNDER RTOS (Continued) 

DPn - Moving head disk, unit_n (n can be from to 3). 

$LPT - 80- or 132 -column line printer. 

$LPT1 - Second line printer, 80 or 132 columns. 

MCAR - Multiprocessor Communications Adapter Receiver. 

MCAT - Multiprocessor Communications Adapter Transmitter. 

MTn - 7- or 9-track magnetic tape transport (n can be from 

to 7). 

$PLT - Incremental plotter. 

$PLT1 - Second incremental plotter. 

$PTP - Paper tape punch. 

$PTP1 - Second paper tape punch. 

$PTR - High-speed paper tape reader. 

$PTR1 - Second paper tape reader. 

QTY - 4060 asynchronous data communications multiplexor. 

$TTI - Teletype* or video display terminal keyboard. ** 

$TTI1 - Second teletype or display terminal keyboard. ** 

$TTI2 - Third teletype or display terminal keyboard. ** 

$TTO - Teletype printer or display terminal screen. 

$TT01 - Second printer or display terminal screen. 

*TTQ2 - Third ™rinter or dis^la" terminal screen. 

MAGNETIC TAPE AND CASSETTE UNITS 



RTOS accesses data on magnetic tape and cassettes in free format. A single 
system may contain up to eight magnetic and eight cassette tape drives. Magnetic 
I tape units can be in any combination of 7- and 9-track units at high or low desnity. 

Initializing and Releasing a Tape Drive 

Before any tape files on a tape drive can be accessed, the drive must be initialized 
via the .INIT system call. Initializing a tape drive causes the tape on that drive 
to be rewound. Full initialization causes the tape to be rewound and two EOF's 

■f-/-Y t-\.r. iiTvi t-f-^-i-n /<-*£•£/-%./-> fi'tTrtlir /-i-**o n ir» r*> oil -Pi 1 ^n £-*~r\-m +-1-4 £± t-<-»T-\a 1 Tr> Vv* f*V\ r> O c?£io fhci f-ono f ll O 

pointer maintained by RTOS is reset to 0. 

The system call .RLSE is issued to remove the transport from the system, reset 
the tape file pointer, and rewind the tape. 



Teletype® is a registered trademark of Teletype Corporation, Skokie, Illinois. 
All references to teletypes in this manual shall apply to this mark. 

**If the teletype reader is turned on for line reads, data read will be echoed on 
the teletype printer. 
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Free Format I/O 

Data is read and written on magnetic and cassette tape in free format. Data 
records may be of varying length, containing from 2 to 4096 16-bit words each, 
and with 1 or more records per file. Each tape reel can contain as many files as 
the reel size will permit, although only the first 100 files can be positioned 
directly when a file is opened. 

Before any free format I/O can occur on a. deuce, that device must first be initialized 
and then opened for this type of I/O. The system call . MTOPD is issued to open 

either ma? fane Or r3SSPttPS far fr^e* fnrmat T /r> WVion o ^r>o ,,,-,,•<- A^ ~t^*,~^ ;♦. ;„ 
o — r - — ~~~ ~w * j..lw.w u.w^. x«.*m.i t./ v^. 1 1 u^ii a. ucip\~ mill j.o wpt^u^ia, it 10 

positioned to a specified file, and the unit is associated with an RTOS channel. Thus, 
even though the unit has positioned a tape reel to a. specific file, all files on the 
tape can then be accessed via space forward/space backward commands, and all 
records within each file can be similarly accessed. 

ASYNCHRONOUS DATA COMMUNICATIONS MULTIPLEXOR (QTY) 

The type 4060 asynchronous data communications multiplexor is another device 
supported by RTOS. RTOS assigns the system mnemonic QTY to this device. 
The QTY can accommodate from 1 to 64 full or half duplex lines, in either half or 
full duplex operation. 

Each multiplexed line of the QTY corresponds to a file name of the form 
QTY: xx 

where xx is a multiplexor line number in the range 0-64 decimal. Input/output 
operations are performed on each line by RTOS Ime or sequential read and 
write commands. 

Each single QTY line may be opened on a single RTOS channel only. No more than 
one read or one write request can be outstanding on any one line. 

RTOS provides a facility for monitoring line activity on all unopened QTY lines. 
If line number 64, QTY:64, is opened and either a read line or read sequential 
operation is attempted, the task issuing this call will be suspended until such 
time as an unopened line receives an interrupt request. When this occurs, the 
normal return of the read sequential or read line call will be taken, and AC2 
will contain the following data word: 



1 Line # Char. 



12 7 8 15 
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ASYNCHRONOUS DATA COMMUNICATIONS MULTIPLEXOR (QTY) (Continued) 

Thus this data word describes the line providing the character, and contains the 
character itself in its right byte. 

If two unopened lines receive an interrupt, only the first one to receive the 
interrupt will be reported. There will be no report of other unopened interrupting 
lines occurring before the next read line or read sequential on QTY:64 is issued. 

DISK FILES 



RTOS extends support to both fixed and moving head disk units. RTOS supports 
a fixed head NOVADISC controller with up to eight logical units of 128K, 25 6K, 
512K or 756K storage words; total fixed head storage per controller is from 131 
thousand to 2 million words. Up to four moving head disk devices (disk pack or 
cartridge type) can also be included in any system, with from 2 to 20 surfaces 
per unit; maximum total moving head disk storage is 49.2 million words. 

Disk files are defined at the time of system generation. At this time, file sizes 
are specified and names are assigned to each file. File names consist of from 4 
to 6 ASCII characters followed by a trailing null. Allowable ASCII characters in the 
file name are all upper case alphabetic characters and numerals through 9. A file 
must be opened (i. e. , associated with an RTOS channel) before it can be accessed. 

Disk File Organization 

Disk files in RTOS may be organized contiguously only. Contiguously organized 
files consist of a fixed number of one or more disk blocks located at an unbroken 
series of disk block addresses. These files can be neither expanded nor reduced 
in size. Since the data blocks are at sequential logical block addresses, all that 
is needed to access a block within a contiguous file is the address of the first 
block and the relative block number within the file. 
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Disk File Organization (Continued) 
File ABCD 



all 256 
words are 
utilized 
for data 
storage 



r 



Block Address N 



v 



Block Address N+l 



Relative Block No. 



Block Address N+2 



Relative Block No. 1 



Relative Block No. 2 



Contiguously organized files have the advantage of allowing quick access to their data 
blocks, with all disk storage being used for data. 

RTOS/RDOS COMPATIBILITY 

The design intent of RTOS is to make this operating system a compatible subset 
of RDOS, the DGC Real Time Disk Operating System. Accordingly, all file 
structures, task concepts, system and task calls, and other features discussed for 
7TOS may be tested and run on an RDOS system. RDOS features omitted from RTOS 
were omitted because they could not be applied in RTOS, given the constraints of a 
quick responding core-resident -only operating system. 

Tape and Disk File Structures 

Cassette and magnetic tape file structures under RTOS are identical to those 
provided by free format I/O under RDOS. 

Disk files in RTOS must be organized contiguously; sequentially and randomly 
organized disk files are available only under RDOS. Names are assigned to RTOS 
disk files at RTOSGEN time. Allowable ASCII characters in RTOS file names are 
all upper case alphabetics and numerals through 9. Unlike RDOS, however, 
disk file names must be 4 to 6 characters in length, may not include the $ character, 
and can have no file name extensions; file names defined at RTOSGEN time cannot 
be changed. Disk files must be opened before they may be accessed. 



Task and System Calls 

Unless otherwise specified, all RTOS system and task calls operate as 

they do under RDOS . Any attempt to reference a task call under RTOS which is not 



1-9 



Task and System Calls (Continued) 

found in its library will cause an unresolved external to be reported by the loader. 

In most cases, an attempt to execute an RDOS system call which is not implemented 
in RTOS results in an error return being taken with error code 2, ERICM (illegal 
system command), reported in AC2. However, some calls are treated as no-ops 
by RTOS to achieve downward compatibility (from RDOS to RTOS). The following 
list names all of these calls which cause control to go directly to the normal return 
with no further action: 

. CCONT Create a contiguous file. 

. CRAND Create a random file. 

.DELET Delete a file. 

. RENAM Rename a file. 

.SYSI SOS -compatible call. 

. SPKL Kill spooling. 

. SPDA Disable spooling. 

. SPEA Enable spooling. 

Note that these calls will not operate correctly under RTOS in the presence of 
error conditions. Thus, for example, an attempt to delete a non-existent file would 
take the error return for .DELET under RDOS, but would take this call's normal 
return under RTOS. 

Channel /Task Specification 

The number of channels and tasks in a program run under RTOS is defined at 
RTOSGEN time. RTOS programs being tested under RDOS may specify channels 
and tasks by means of the RLDR local switches /C and /K, or by the .COMM TASK 
(or CHANT ASK) statements. 

RTOS Program Development Under RDOS 

Bearing in mind the above restrictions, RTOS program development under an RDOS 
system is convenient. RTOS programs are edited, assembled, loaded and debugged 
under RDOS, and when they are considered to be error free they are reloaded with 
an RTOS module (produced by RTOS SYSGEN) and the RTOS library, using the RDOS 
RLDR command with the /C global switch. This load procedure creates a version of 
the program (called a save file) which can be run under RTOS. 

Having created this save file, one of several bootstrap procedures are followed to 
execute the program, depending upon whether the RTOS program is to be run on the 
system which is currently executing under RDOS or whether it is to be run under 
another system, with or without disk, which is not running under RDOS. 
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RTOS Program Development Under RDOS (Continued) 

Complete details describing the use of the RDOS RLDR command, operation of 
TBOOT, CBOOT, HIPBOOT, and procedures for relocatable loading of an RTOS 
program module on a stand-alone system are outlined in Appendix B of this manual. 

Avoiding Global Symbol Conflicts under RTOS 

In order to minimize the incidence of global symbol conflicts between user pro- 
grams and RTOS subprograms, RTOS generally follows the convention of using a dot 
as the first character in each svmbol. Thus user -defined «iobal symbols should 
always avoid the use of a dot as the first character in a symbol. 

This rule has several exceptions which users should be aware of, i.e. , several 
global symbols in RTOS are not preceded by dots. These undotted global symbols 
are as follows: PWRIS, RTCIS, DCT names (summarized at the end of system 
generations), entries in the buffer package (BFPKG), entries in Fortran libraries 
FORT. LB and RTOS FMT. LB, and user high priority interrupt handlers. 

Generating Console Interrupts 

RTOS does not permit the generation of console interrupts (CTRL A, CTRL C, or 
CTRL F) which are available under RDOS. Nonetheless, RTOS does provide a 
facility which resembles an RDOS keyboard interrupt. This facility is the keyboard 
character wait command, .WCHAR . This command, discussed fully in Chapter 2. 
activates logic within RTOS such that when a user-specified character is received 
from any console keyboard, control will branch to a user -specified routine for 
appropriate processing. 

Inter -revision Source Level Incompatibilities 

Users of RTOS 05 who wish to be upgraded to RTOS 3. 00, the current revision, 
should be aware of certain source level incompatibilities between the two revisions. A 
summary of these considerations is given in Appendix E. 
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CHAPTER 2 
SYSTEM CALLS 



following page contains an alphabetized bst of all RTOS system command word 
monies. 



The 
mnemonics 



All system calls except user interrupt calls will be discussed in this chapter, with 

File and Input/Output Commands 
Teletypewriter /Video Display Commands 
Memory Size Commands 
System Return Commands 

Clock and Calendar Commands 

FILE AND INPUT/OUTPUT COMMANDS 

All I/O is handled by system I/O commands. These commands require a channel 
number from to 77 to be given in the argument field of the command word as 
discussed in Chapter 1. The number of channels available is determined by the 
user when the RTOS module is generated by the user (see Appendix B). 

The user may also define a number of fixed length files when the RTOS module 
is generated, and may assign alphanumeric names to these files. Such files 
are organized contiguously, and are composed of a fixed number of disk blocks 
which are located at an unbroken series of physical block addresses. These 
liles can neither be expanded nor reduced in size. Since the data blocks are in 
sequence, all that is needed to access a block within a contiguous file is the 
name of the file (indicating to RTOS the address of the first block) and the relative 
block number within the file. Since no time is required for reading a file index, 
disk files under RTOS can be accessed rapidly. 
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System Call List 



. APPEND 

.CLOSE 

.DELAY 

.DUCLK 

. ERTN 

. GCHAR 

. GCHN 

.GDAY 

.GHRZ 

.GMCA 

.GTOD 

.IDEF 

.INIT 

.IRMV 

.MEM 

.MEMI 

. MTDIO 

. MTOPD 

. OPEN 

.PCHAR 

.RDB 

.RDL 

.RDS 

.RESET 

.RLSE 

.RTN 

.RUCLK 

.SDAY 

.STOD 

wr'ij A D 

• II VJ11I11V 

.WRB 
.WRL 
.WRS 



Append to a device. 

Close a file or device. 

Suspend a task for a specific interval of time. 

Define a user clock. 

Idle the system abnormally. 

Get a character. 

Get a free channel number. 

Get today's date. 

Get the real time clock frequency. 

Get the current CPU's MCA number. 

Get the time of day. 

Identify a user interrupt device. 

Initialize a magnetic tape or cassette. 

Remove a user interrupt device. 

Determine available memory. 

Change NMAX. 

Open a magnetic tape or cassette for free format I/O. 

Open a file or device other than the magnetic tape or cassette. 

Output a character to the teletypewriter. 

Read a disk block. 

Read a line. 

Read sequential bytes. 

Close all devices and files. 

Release a magnetic tape or cassette unit. 

Idle the system normally. 

Remove a user clock. 

Set today's date. 

Set the time of day. 

vv axi xvjj. a. uiaiauici un a LCiCLypc. 

Write a disk block. 

Write a line. 

Write sequential bytes. 
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FILE AND INPUT/OUTPUT COMMANDS (Continued) 

A channel is initially linked to a particular file or device by means of the . OPEN 
(or . APPEND) command. A channel is linked to a magnetic tape transport or 
cassette unit ^y means of the . MTOPD command only. The association between 
file or device and channel number is broken by using the . CLOSE command. All 
currently open files and csvices can be closed, and their associated channels 
freed, by means of the system .RESET command. 

RTOS provides four different I/O modes for reading and writing. These modes 
are: 

direct block 

line 

sequential 

free format tape I/O 

In direct block mode, the user effects a transfer of a continuous group of disk 
blocks. Core locations used in the transfer are also in sequence. The direct block 
mode commands are . RDB and . WRB, read a block series and write a block series. 
This mode is used only with disk I/O, and no other I/O mode is used for disk I/O 
under RTOS. 

Line mode data transfers assume that the data read or written consists of ASCII 
character strings terminated by either carriage returns, form feeds, or nulls. 
Position within a file is implicit from the last call. That is, file data is processed 
line by line in sequence from the beginning of the file to its end. In this mode the 
system handles all device dependent editing at the device driver level. For 
example, line feeds are ignored on paper tape and teletype input devices and are 
supplied after carriage returns to all paper tape and teletype output devices. 
Moreover, reading and writing do not require byte counts since reading continues 
until a terminator is read and writing proceeds until a terminator is written. The 
line mode commands are .RDL and .WRL, read and write a line. 

The third mode is sequential mode . In this mode data is transmitted exactly as 
read from the device or from core memory. No assumption is made by the system 
as to the nature of this information. Thus this mode would always be used for 
processing binary data. This mode requires the caller to specify a byte count for 
each read or write request. The sequential mode commands are . RDS and .WRS, 
read and write sequential. 

Free format I/O permits the reading or writing of data on a word by word basis 
to cassette or magnetic tape. This mode provides users with the means of accessing 
data in variable size records within tape files. Free format I/O permits the 
reading or writing of data records containing from 2 to 4096 words each. Free 
format I/O commands also permit a tape reel to be spaced forward or backward 
from 1 to 4095 records or to the start of a new data file, and these commands permit 
the transport status word to be read. 
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FILE AND INPUT/OUTPUT COMMANDS (Continued) 

Before free format I/O operations can be performed, the cassette or magnetic 
tape unit must be initialized (.INIT) and opened (.MTOPD). To prevent further 
I/O access from occurring, the device is released (. RLSE) and its channel is 
closed (.CLOSE). 

Open a File or Device (.OPEN) 

Before other I/O commands can be used, files and devices must be linked to channels. 
Two parameters must be passed to .OPEN : a byte pointer to the device or file 
name string, and a characteristic inhibit mask. 

For every bit set in the characteristic inhibit mask word a corresponding device 
characteristic is inhibited. (This mask is ignored when . OPEN is opening a file. ) 
Furthermore, these characteristics will be inhibited for as long as the device 
remains open. The following lists the bit assignments, characteristic mnemonics, 
and the characteristics in the inhibit mask: 

Bit Mnemonic Meaning 

1 DCC80 80 -column device. 

2 DCLTU Device changing lower case ASCII to upper case. 

3 DCFFO Device requiring a form feed on open. 

4 DCFWD Full word device (reads or writes more than a 

byte). 

6 DC LAC Device requiring line feeds after carriage returns. 

7 DCPCK Input device requiring a parity check; output 

device requiring parity computation. 

8 DCRAT Output device requiring a rubout after every tab. 

9 DCNAF Output device requiring nulls after every form 

feed. 

10 DCKEY A keyboard input device. 

11 DC TO A teletype output device. 

12 DCCNF Output device without form feed hardware. 

14 DCCGN Output device without tabbing hardware. 

15 DCCPO Output device requiring leader/trailer. 

If an MCA line is being opened, AC1 cannot contain a characteristic inhibit mask. 
Instead, for receiver lines, AC1 must be cleared to all zeroes. If a transmitter 
line is to be opened and the default number of retries (specified at RTOSGEN 
time) is to be used, AC1 must be cleared to all zeroes. However, if a different 
timeout value is to be specified, bit 15 of AC1 must be set to one (and all other 
bits in AC1 must be cleared). The actual specification of a retry count will then 
be deferred to the time the write sequential I/O command (.WRS) is issued. 
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Open a File or Device (. OPEN) (Continued) 

Having opened a file via .OPEN, the user is not guaranteed of being the exclusive 
user of the file; others may also have opened the file via . OPEN and may have 
modified its contents. This command cannot be used to open a cassette or 
magnetic tape file. 

The format of the . OPEN command is: 

ACO - Byte pointer to file or device name terminated by a null. The 
pointer must be even, i. e., the string must begin on a full word 
boundary. 

AC1 - Characteristic inhibit mask. 

.SYSTM 

. OPEN n ; OPEN CHANNEL n 

error return 

normal return 

In general, the user will wish to preserve all device characteristics as defined by 
the system. This can be accomplished by preceding the . OPEN call with a SUB 
1, 1 instruction, passing an all -zero mask in AC1. 

As an example, if the user wishes to read an ASCII tape without parity from the 
high speed reader, he may inhibit parity checking by the following command 
sequence: 

LDA 0, READR 

LDA 1, MASK 

.SYSTM 
. OPEN 3 

READR: .+1*2 

.TXT *PTR* 
MASK: DCPCK ;PARITY CHARACTERISTIC 

Possible errors resulting from the .OPEN command are: 

Meaning 

Illegal channel number. 

Illegal file name. 

File does not exist. 

Attempt to use channel already in use. 

Unit improperly selected. 

Attempt to open a busy MCA unit. 
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AC2 


Mnemonic 





ERFNO 


1 


ERFNM 


12 


ERDLE 


21 


ERUFT 


31 


ERSEL 


60 


ERFIU 



Get the Number of a Free Channel (. GCHN ) 

This call enables the user to obtain the number of a channel that is currently unused, 
if any, so that a file may be opened on this channel via one of die file open calls. 
. GCHN does not open a file on a free channel; it merely indicates a channel that is 
free at the moment. Thus if . GCHN is issued in a multitask environment where it 
is followed by a call to one of the file open commands, the channel may not be free 
by the time the file open call is issued. To solve this problem, the user should 
process error return ERUFT ("Channel already in use") given by die file open 
command by reissuing the call to . GCHN; this will ensure that a truly free channel 
is discovered. 

The format of this call is: 

•SYSTM 
.GCHN 
error return 
normal return 

Upon a normal return, the channel number is returned in AC2 : 



One possible error return may occur. 

AC2 Mnemonic Meaning 

21 ERUFT No channels are free. 

Open a Device for Appending (.APPEND ) 

An alternate system call for opening a device is implemented that is identical to 
. OPEN in every respect except that it may not be used with disk files. 

This routine requires the same two input parameters as does . OPEN, viz. , a 
byte pointer to the device name string, and a characteristic inhibit mask. The 
mask bit definitions are as described earlier for . OPEN . 

The format of the .APPEND command is: 

ACO - Byte pointer to device name. The pointer must be even, i.e. , the string 
must begin on a full word boundary. The string must be terminated by a 
null. 

AC1 - Characteristic inhibit mask. 
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Open a Device for Appending (.APPEND) (Continued) 

. SYSTM 
.APPEND n 
error return 
normal return 

Possible errors resulting from the .APPEND command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

21 ERUFT Attempt to use channel already in use. 

Close a File or Device (. CLOSE) 

This command closes a device (performing any housekeeping required like trailer 
output) and frees the device channel. If a file is closed, the file's channel is 
released. The format of the .CLOSE command is: 

.SYSTM 

.CLOSE n ; CLOSE CHANNEL n 

error return 

normal return 

Possible errors resulting from a .CLOSE command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

15 ERFOP Attempt to reference a channel not in use. 

Close all Files and Devices (. RESET) 

This command causes all currently open files and devices to be closed. The 
format of the . RESET command is: 

I 

.SYSTM 
.RESET 
error return 
normal return 

The error return is never taken. 
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Initialize a Magnetic Tape Unit or Cassette (. INIT ) 

Before free format tape I/O can occur, the magnetic tape unit or cassette must be 
initialized. Initialization for a magnetic tape unit or cassette consists of making 
the device known to the system, rewinding the tape to BOT, and resetting the tape 
file pointer to zero. 

A full initialization causes the tape to be rewound to BOT and two end -of -file marks 
to be written. This effectively erases any information which may have been on the 
tape. A partial initialization causes the tape to be rewound to BOT and resets the 
system tape file pointer to zero; no end of file mark is written. 

Input parameters to this call are as follows : 

ACO - Byte pointer to cassette or magnetic tape name (e.g. , MTO, CT2, etc. ). 

The byte pointer must be even, i.e. , the string must begin on a full 

word boundary. 
AC1 - -1 for full initialization; other values indicate a partial initialization. 

The format of the . INIT command is: 

. SYSTM 
.INIT 

error return 
normal return 

Possible errors resulting from an . INIT command are: 

AC2 Mnemonic Meaning 

2 ERICM Illegal command for device. 

31 ERSEL Unit improperly selected. 

36 ERDNM Device not in system. 

45 ERIBS Device already initialized. 

Open a Cassette or Magnetic Tape Unit for Free Format I/O (.MTOPD) 

Before free format reading or writing can be performed on either an initialized 
magnetic tape or cassette unit, the device must be opened and be linked to an 
RTOS channel. The RTOS command to open files or devices (.OPEN) cannot 
be used to open a magnetic or cassette tape unit for free format I/O; only 
.MTOPD can be used to open these devices. 
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Open a Cassette cr Magnetic Tape Unit for Free Format I/O (.MTOPD) (Continued) 

Input parameters to this call are the same as for the .OPEN command. .MTOPD 
positions a free format tape to a desired file, since the file name passed to .MTOPD 
will be of the form MTn:m or CTn:m . The input parameter to . MTOPD is as 
follows: 

ACO - Byte pointer to cassette or magnetic tape file name terminated by a null. 
The pointer must be even, i. e. , the string must begin on a full word 

The format of the MTOPD command is : 

.SYSTM 

. MTOPD n ;n IS THE CHANNEL NUMBER 

error return 

normal return 

Possible errors resulting from a .MTOPD command are: 

Meaning 

Illegal channel number. 

Illegal file name. 

File does not exist. 

Attempt to use channel already in use. 

Unit improperly selected. 

Release a Magnetic Tape Unit or Cassette (.RLSE) 

To prevent further file access to either a magnetic tape or cassette unit, the system 
command . RLSE must be issued. This command prevents further file access until 
the device is initialized (see the . INIT command), and causes the tape to be rewound 
to BOT. 

One input parameter is required for this call: 

ACO - Byte pointer to device name. The byte pointer must be even, i.e. , the 
string must begin on a full word boundary. 

The format of this call is : 

.SYSTM 
• RLSE 
error return 
normal return 
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.C2 


Mnemonic 





ERFNO 


1 


ERFNM 


12 


ERDLE 


21 


ERUFT 


31 


ERSEL 



Release a Magnetic Tape Unit or Cassette (. RLSE) (Continued) 
Possible errors resulting from an .RLSE command are: 

AC2 Mnemonic Meaning 

2 ERICM Illegal command for device. 

36 ERDNM Device not in system. 

Read a Series of Disk Blocks (. RDB) 

This command causes a series of disk blocks to be read into a user -specified 
area in core memory. This routine requires four input parameters including 
the number of the channel upon which the disk file was previously opened. These 
parameters are: the starting disk block number within the disk file, the number 
of disk blocks to be read, and the starting (i.e. , lowest) core address to receive 
the data. In the case where the channel number n in the command argument is set 
to 77, the right byte of AC2 contains the channel number. The left byte of AC2 
contains the number of blocks to be transferred. Each block that is read contains 
256 16-bit words of disk storage. 

The format of the .RDB command is: 

ACO - Starting core address to receive the data. 

AC1 - Starting relative disk block number. 

AC2, left byte - Number of blocks to be read. 

AC2, right byte - Optional channel number. 

.SYSTM 

.RDB n ;n IS THE CHANNEL NUMBER. 

error return 

normal return 

Possible error codes resulting from an .RDB command are: 
AC2 Mnemonic Meaning 

Illegal channel number. 
Illegal command for device. 
End of file. 
File is not opened . 

Upon detection of error EREOF the error code is returned in the right byte of 
AC2; the left byte of AC2 contains the partial read count. 
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ERFNO 


3 


ERICD 


6 


EREOF 


15 


ERFOP 



Read a Line (. RDL) 

This command causes an ASCII line to be read. Required input to this command 
is a byte pointer in ACO to the starting byte address within the user area into 
which the line will be read. This area should be 133 bytes long. 

Reading will be terminated normally after a carriage return, form feed, or null 
is detected. Reading will be terminated abnormally after reading 132 (decimal) 
characters without detecting a carriage return, form feed, or null; upon 
detecting a parity error; or nnnn an <=>nd of file. In all raceq the r^^r\ u^to mnnh 
including the carriage return, form feed, or null, will be returned in AC1. 

If the read is terminated because of a parity error, the character having the 
incorrect parity will be stored (with its parity bit cleared) as the last character 
read. The byte pointer to the character in error can always be computed as: 

(ACO) + (ACl)-l 

The format of the .RDL command is: 

ACO - Starting byte address. 

.SYSTM 

• RDL n ;READ FROM CHANNEL n 

error return 

normal return 

AC1 - Byte count. 

Possible errors resulting from a .RDL command are: 
AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

3 ERICD Illegal command for device. 

6 . EREOF End of file. 

15 ERFOP Attempt to read an unopened file. 

22 ERLLI Line limit (132 characters) exceeded. 

24 ERPAR Parity error. 

47 ERSIM Simultaneous reads on same QTY line. 

106 ERCLO QTY input terminated by channel close. 



(ACn) means "contents of ACn" 
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Read Sequential (. RDS) 

This command causes a sequential mode data transfer, causing data to be read 
exactly as is. Required input parameters to this command are as follows: a byte 
pointer to the starting byte address within the user area into which data will be 
read, and the number of bytes (2 1 ^-1 maximum) to be read. 

The format of the . RDS command is : 

ACO - Starting byte address. 
AC1 - Number of bytes to be read. 

.SYSTM 

.RDS n ;READ SEQUENTIAL FROM CHANNEL n 

error return 

normal return 

Possible errors resulting from an .RDS command are: 

Meaning 

Illegal channel number. 

Illegal command for device. 

Attempt to read an unopened device or file. 

Simultaneous reads on same QTY line. 

QTY/MCA input terminated by channel close. 

Use of the Card Reader in . RDL and . RDS Commands 

When using $CDR or $CDR1, the end of file condition on a . RDL will occur only if 
a special end of file code is detected in column 1 of a card. This code is "all rows 
punched. " It can be punched on a 029 keypunch by multipunching "+", "-", and "0" 
through "9. " 

Note also that a Hollerith to ASCII, translation only occurs if a .RDL has been 
requested. The translation assumes 029 keypunch codes. A table of Hollerith- 
ASCII translation is given in this section. 

A . RDL is terminated upon the first trailing blank (which is translated as a 
carriage return). If all 80 columns are data, a carriage return is appended as the 
eighty -first character. If an illegal character is detected, a back slash is sub- 
stituted for the illegal character. 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


15 


ERFOP 


47 


ERSIM 


106 


ERCLO 
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Use of the Card Reader in . RDL and . RDS Commands (Continued) 

In an .RDS command, the card is read in image binary. Each two bytes will be 
used to store a single column. The packing is done as follows: 



Byte 



-> <r 



Column Number 



1 1 



0123456789 



2 1 

Bit 012 34 5 6789111111 

12 3 4 5 




The "d's" will be 1 for every column punched. 

The byte count and byte pointer input to an . RDS command must both be even. 
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CHAR. 


CARD CODE 


ASCII CODE 


CHAR. 


CARD CODE 


ASCII CODE | 


NUL 


12-0-9-8-1 


000 


SPACE 


NO PUNCHES 


040 


SOH 


12-9-1 


001 


i 


12-8-7 


04 1 


STX 


12-9-2 


002 


■• 


8-7 


04 2 


ETX 


12-9-3 


003 


# 


8-3 


043 


EOT 


9-7 


004 


$ 


1 1-8-3 


044 


ENQ 


0-9-8-5 


005 


% 


0-8-4 


045 


ACK 


0-9-8-6 


006 


& 


12 


046 


BEL 


0-9-8-7 


007 


' or 


8-5 


047 


BS 


11-9-6 


010 


( 


12-8-5 


050 


HT 


12-9-5 


011 


) 


11-8-5 


051 


LF 


0-9-5 


012 


* 


11-8-4 


052 


VT 


12-9-8-3 


013 


+ 


12-8-6 


053 


FF 


12-9-8-4 


014 


y 


0-8-3 


054 


CR 


12-9-8-5 


015 


- 


11 


055 


SO 


12-9-8-6 


016 


. 


12-8-3 


056 


SI 


12-9-8-7 


017 


1 


0-1 


057 


DLE 


12-11-9-8-1 


020 








060 


DC1 


11-9-1 


021 


l 


1 


061 


DC 2 


1 1-9-2 


022 


2 


2 


062 


DC3 


11-9-3 


023 


3 


3 


063 


DC4 


4-8-9 


024 


4 


4 


064 


NAK 


9-8-5 


025 


5 


5 


065 


SYN 


9-2 


026 


6 


6 


066 


ETB 


0-9-6 


027 


7 


7 


067 


CAN 


11-9-8 


030 


8 


8 


(F0 


EM 


11-9-8-1 


031 


9 


9 


071 


SUB 


9-8-7 


032 




8-2 


072 


ESC 


0-9-7 


033 


» 


11-8-6 


073 


FS 


11-9-8-4 


034 


< 


12-8-4 


074 




I 1-y-O-D 


/-\ fir 
\JJO 


= 


8-6 


075 


RS 


11-9-8-6 


036 


> 


0-8-6 


076 


US 


11-9-8-7 


037 


? 


0-8-7 


077 



Hollerith - ASCII Translation Table 
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CHAR. 


CARD CODE 


ASCII CODE 




r>i_r a d 

\S1 uuv. 











8-4 


100 




\ 


8-1 


140 


A 


12-1 


101 a 


12-0-1 


141 


B 


12-2 


102 b 


12-0-2 


142 


C 


12-3 


103 c 


12-0-3 


143 


D 


12-4 


104 d 


12-0-4 


144 


E 


12-5 


105 e 


12-0-5 


145 


F 


12-6 


106 f 


12-0-6 


146 


G 


12-7 


107 g 


12-0-7 


147 


H 


12-8 


110 h 


12-0-8 


150 


I 


12-9 


111 i 


12-0-9 


1 C 1 

x <J 1 


J 


11-1 


112 j 


12-11-1 


152 


K 


11-2 


113 k 


12-11-2 


153 


L 


11-3 


114 I 


12-11-3 


154 


M 


11-4 


115 m 


12-11-4 


155 


N 


11-5 


116 n 


12-11-5 


156 





11-6 


117 o 


12-11-6 


157 


P 


11-7 


120 p 


12-11-7 


160 


Q 


11-8 


121 q 


12-11-8 


161 


R 


11-9 


122 r 


12-11-9 


162 


S 


0-2 


123 s 


11-0-2 


163 


T 


0-3 


124 t 


11-0-3 


164 


U 


0-4 


125 u 


11-0-4 


165 


V 


0-5 


126 v 


11-0-5 


166 


w 


0-6 


127 w 


11-0-6 


167 


X 


0-7 


130 x 


11-0-7 


170 


Y 


0-8 


131 y 


11-0-8 


171 


Z 


0-9 


132 z 


11-0-9 


172 


[ 


12-8-2 


133 { 


12-0 


173 


\, 


0-8-2 


134 | 


12-11 


174 


J 


11-8-2 


135 ] 


11-0 


175 


— i or t 


11-8-7 


136 ^ 


11-0-1 


176 


— 


or — 


0-8-5 


137 




DEL 


12-9-7 


177 



Hollerith - ASCII Translation Table (Continued) 
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Write a Series of Disk Blocks (.WRB) 

This command causes a series of data blocks, each 256 1 6-bit words in size, to 
be written onto disk from a user- specified area in core memory. This routine 
requires four input parameters including the number of the channel 
upon which the disk or disk file was previously opened. These parameters are: the 
starting relative disk block number within the file , the number of disk blocks to be 
written, and the starting (i. e. , lowest) core address to transmit the data. In 
the case where the channel number n in the command argument field is set to 77, 
the right byte of AC2 contains the channel number. The left byte of AC2 contains 
the number of blocks to be written. 

The format of the .WRB command is: 

ACO - Starting core address to transmit the data. 

AC1 - Starting relative disk block number. 

AC2, left byte - Number of blocks to be read. 

AC2, right byte - Optional channel number. 

. SYSTM 

.WRB n ;n IS THE CHANNEL NUMBER 

error return 

normal return 

Possible error codes resulting from an . WRB command are: 

AC2^ M nem onic Meaning 

Illegal channel number. 
Illegal command for device. 
File is not opened. 
Disk space is exhausted. 

Upon detection of error ERSPC, the error code is returned in the right byte of 
AC2; the left byte of AC2 contains the partial write count. 

Write a Line (.WRL) 






ERFNO 


3 


ERICD 


15 


ERF OP 


27 


ERSPC 



This command writes a line to a user ASCII file. Required input to this command 
is a byte pointer in ACO defining the user core area from which writing will occur. 

Characters are written with even parity and writing will be terminated normally 
upon encountering a null, carriage return, or form feed. Writing will be 
terminated abnormally after the transmission of 132 (decimal) characters if 
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Write a Line (.WRL) (Continued) 

the 133rd character is not a carriage return, form feed, or null. In all cases, 
AC1 will contain, upon termination of the write, the number of bytes written from 
the user area. The termination of a write line on a null allows formatting of output 
without forcing a carriage return. 

The format of the .WRL command is: 

ACO - Starting byte address. 

•SYSTM 

• WRL n ;WRITE FROM CHANNEL n 

error return 

normal return 

AC1 - Byte count. 

Possible errors resulting from the .WRL command are: 

Meaning 

Illegal channel number. 
Illegal command for device. 
Attempt to write an unopened file. 
Line limit (132 characters) exceeded. 
Simultaneous writes on same QTY line. 
QTY output terminated by channel close. 

Write Sequential (.WRS) 

This command writes binary data from a user core area. In addition to the channel 
number, two parameters are input: a byte pointer to the starting address of the 
user area, and the number of bytes (2 1 ^-1 maximum) to be written. The byte pointer 
must be even if this call is issued for an MCA transmission. To transmit an end -of - 
file in an MCA transmission, a byte count of zero is used in AC1 and the contents of 
ACO are disregarded. Also, if the MCA transmit line was opened with a timeout to 
be specified, the left byte of AC2 input to .WRS specifies the length of the timeout 
period. Each unit period is approximately 200 milliseconds, and acceptable multiples 
input in AC2 are 1 to 255 decimal. A zero value yields the default timeout period 
specified at RTOSGEN time. 



^.C2 


Mnemonic 





ERF NO 


3 


ERICD 


15 


ERFOP 


22 


ERLLI 


47 


ERSIM 


06 


ERCLO 
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Write Sequential (.WRS) (Continued) 

The format of the .WRS command is: 

ACO - Starting address of the data within the user area. 

AC1 - Byte count. 

AC2, left byte - Optional timeout constant. 

AC2, right byte - Optional channel number. 

.SYSTM 

• WRS n ;WRITE TO CHANNEL n 

error return 

normal return 

Possible errors are: 

AC2 Mnemonic Meaning 

Illegal channel number. 

Illegal command for device. 

Attempt to reference an unopened file or device. 

Simultaneous writes on same QTY line. 

Timeout has occurred. 

No complementary MCA request. 

Incomplete MCA transmission due to short receiver 

request. 

MCA/QTY output terminated by channel close. 
No MCA receiver request. 

Free Format Tape I/O (. MTDIO) 

This command permits the operation of magnetic tape and cassette units on a 
machine level: To read and write words in variable length records of from 2 
to 4096 words within a data record, to space forward or backward from 1 to 
4095 data records or to the start of a new data file, and to perform other similar 
machine level operations. Before free format I/O can be performed on a tape unit, 
that unit must first have been opened for free format I/O by means of the . MTOPD 
system command. 

The input parameters to .MTDIO are as follows: 

ACO - Core data address, if data is to be transferred. 
AC1 - Command word, subdivided into the following fields: 






ERFNO 


3 


ERICD 


15 


ERFOP 


47 


ERSIM 


101 


ERDTO 


103 


ERMCA 


104 


ERSRR 


106 
113 


ERCLO 
ERNMC 
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Free Format Tape I/O (. MTDIO) (Continued) 

bit 0: set to 1 for even parity, for odd parity. 

bits 1-3: set to one of the seven command codes which follow. 

- read (words)* 

1 - rewind the tape 

3 - space forward (over records or over a file of any size) 

4 - space backward (over records or over a file of any size) 

5 - write (words) 

6 - write end of file 

7 - read device status word 

bits 4-15: word or record count. If on a space forward (or space 

backward) command, the tape is positioned to the beginning 
of the next (or previous) file on the tape. If on a read or 
write command 4096 words are read (or written) unless an 
end of record is detected. 

AC2 - channel number if n equals 77g. (Note that when a file is opened for 
free format I/O, it is opened globally. That is, all files on the 
specified device can be accessed. ) 

The format of the . MTDIO command is: 

.SYSTM: 

. MTDIO n ;n IS THE CHANNEL NUMBER 

error return 

normal return 

Upon a rewind or read status command, if no system error is detected, AC2 returns 
containing a status word with one or more of the following bits set: 

bit - error (bit 1, 3, 5, 6, 7, 8, 10 or 14 is set to 1) 

bit 1 - data late 

bit 2 - tape is rewinding 

bit 3 - illegal command 

bit 4 - high density if set to 1; otherwise, low density (always 1 for cassettes) 

bit 5 - parity error 

bit 6 - end of tape 

bit 7 - end of file 



* When attempting to read a 7 -track tape with odd parity (i. e. , a tape not written on 
an RTOS system), the end -of -file is not detected by the controller; the first word 
in the next record is read as 007417. Thus the first record of each file (after the 
first file) has appended to it the end -of -file of the previous file. 
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Free Format Tape I/O (. MTDIO) (Continued) 

bit 8 - tape is at load point 

bit 9 - 9-track if set to 1; otherwise, 7 -track (always set to 1 for casettes) 

bit 10 - bad tape or write failure 

bit 11 - send clock (always set to zero for cassettes)* 

bit 12 - first character (always set to zero for cassettes)* 

bit 13 - write-pro tec ted or write -locked 

bit 14 - odd character (always set to zero for cassettes) 

bit 15 - unit ready. 

For more information about each of these status bits, see "Nova Cassette" or 
"Magnetic Tape" in How To Use the Nova Computers . 

Upon a read, write, space forward, or space backward command, if no system 
error is detected, AC1 contains the number of words written (or read) or the 
number of records spaced. A word or record count is returned in AC1 upon a 
premature end of file. 

Upon detection of a system error, the error return is taken and AC2 is set to 
contain one of the following: 

Meaning 

Illegal channel number. 

Illegal command for device (i. e. , improper open). 

Attempt to reference an unopened file. 

File read error. 

If no system error is detected but a hardware error occurs (i. e. , bit of the 
status word is set), the error return is taken and AC2 is set to the transport status 
word. If no system error and no hardware error occurs, the normal return is 
taken and the transport status word is returned in AC2. 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


15 


ERFOP 


30 


ERFIL 



me luuuwmg uauie summarizes me return taKen ana contents oi n.^i ana a^z witn 
different MTDIO command selections. 



* Bits used for maintenance only. 
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Free Format Tape I/O (.MTDIO) (Continued) 

COMMAND RETURN 



AC1 



AC2 



Any MTDIO command with a 
system error detected 


T— 

Error 


Same as 
input 


System error 
code 


Rewind (TSW bit = 0) 


Normal 


Original 
input is 
lost 


Transport status 
word (TSW) 


Rewind (TSW bit = 1) 


Error 


Read Status (TSW bit = 0) 


Normal 


Original 
input is 
lost 


TSW 

(status bit is 0) 


Read Status (TSW bit = 1) 


Error 


Original 
input is 
lost 


TSW 

(status bit is 1] 


Read, Write, Space Forward, 
Space Backward; bit in TSW 
is set to 


Normal 


Word or 

Record 

count 


TSW 


Read, Write, Space Forward, 
Space Backward; bit in TSW 
is set to 1 


Error 
(only after 
10 retries 
in read/ 
write) 


Write end -of -file 
(TSW bit 0=1) 


Error 


Original 

input is 
lost 


TSW 



The system will perform 10 read retries before taking the error return. For 
write errors, the following sequence will be performed 10 times before taking 
the error return: backspace and write 9 times, then backspace, erase a 2-1/2" 
length of tape, and write. Thus the system will perform 100 write retries before 
signaling an error. 
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TELETYPEWRITER AND VIDEO DISPLAY COMMANDS 

Transfer of single ASCII characters between $TTI/$TTO and ACO is handled by 
the system commands . GCHAR and . PCHAR . No channel is required for the 
transfers, and $TTI/$TTO is always available without requiring a prior .OPEN 
command. 

An additional system call exists which allows a task to be readied upon detection 
of a user-defined character input via a teletype or display keyboard. 

Get a Character ( .GCHAR) 

This command returns a character input via $TTI to ACO. The character is right 
adjusted in ACO with bits 0-8 cleared. No channel is required; the $TTI is always 
used as input for this command. The format of the . GCHAR command is: 

. SYSTM 
. GCHAR 
error return 
normal return 

ACO, bits 9-15 - ASCII input character 

No error return is possible from this command. 

Put a Character (.PCHAR) 

This command transmits a character in ACO, right adjusted, to $TTO. No channel 
is required, and the $TTO is always used with this command. The format of the 
. PCHAR command is: 

ACO, bits 9-15 - ASCII output character 

. SYSTM 
.PCHAR 
error return 
normal return 

No error return is possible from this command. 
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Wait for a Keyboard Character (. WCHAR) 

This command suspends the caller until either a specified character is typed onto 
any console keyboard, or the call is reissued by another task to terminate this 
keyboard wait. QnJy one task may be suspended for a keyboard character wait 
at any one moment. 

The required input to this call is either the keyboard character which will ready the 
task or -1, terminating the keyboard character wait and readying the suspended 
task. These parameters are input via ACO. Since the calling task may be readied 
*jjf >-iuiv.i i-iiv. uaiiouuooiuu ui a ajjcmicu jvcyjjucLLu L;ua.iauLt:i or uy tne Keyooaru wait 
call being terminated, an appropriate code is returned in AC1 when the normal 
return is taken. This code will be either the device code of the console keyboard 
which issued the requested wait character, or -1; -1 indicates that the previous 
wait was terminated. 

The format of this call is: 

ACO - Wait character in right byte, or -1 to terminate another 
task's wait request. 

. SYSTM 
. WCHAR 
error return 
normal return 

AC1 - Device code of the keyboard transmitting the wait character , 
or -1. Minus 1 indicates that the previous wait request 
was terminated. 

The error return is taken if a second task tries to suspend itself for a keyboard 
character while another task is still suspended for a wait character. In this 
case, AC2 is set to the following: 

AC 2 Mnemonic Meaning 

47 ERSIM A previous wait- character request is outstanding. 

MEMORY SIZE COMMANDS 



RTOS provides a pair of system commands used to determine the first location 
available above the loaded user program (NMAX), the highest memory address 
available in user address space (HMA), and a means to increase or decrease the 
address space allocated to the user program by varying NMAX. NMAX is a pointer 
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MEMORY SIZE COMMANDS (Continued) 

contained in the User Status Table at displacement USTNM; this table is discussed 
in Chapter 5, SYSTEM ORGANIZATION . (Note that the /S switch must not be used 
in the RLDR command. ) 



■100, 



Binary Loader 



User Program 



-HMA 



NMAX 



Binary 


Loader 




Symbol 


[ Table 


User 


Program 



-HMA 



NMAX 



Memory Maps with and without Symbol Table 



Determine Available Memor" ( , 



MRM\ 



This command returns the current value of NMAX and the value of HMA. HMA 

represents the location immediately below the bottom of the binary loader (or 

the top of the symbol table). A SUB 1, instruction after the.MEM call determines 

the additional amount of memory available to the user program by putting its 

value in ACO. 

The format of the . MEM command is: 

. SYSTM 
.MEM 

error return 
normal return 

AC1 - NMAX. 
ACO - HMA. 

There are no error returns from this command. 

Allocate Memory by Changing NMAX (.MEMI) 



This command permits the user to increase or decrease the value of NMAX. 
The increment or decrement is passed ( in two's complement) in ACO. This 
command causes the value of NMAX to be updated in the User Status Table, 
and the new value of NMAX is returned in AC1. 
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Allocate Memory by Changing NMAX (. MEMI) (Continued) 

NMAX will not be changed if the new value would be equal to or higher than the 
lowest address of the binary loader. No check is made as to whether or not the 
user decreases NMAX below its original value (as determined at relocatable 
load time) nor, if a symbol table resided in upper memory, whether NMAX is 
increased beyond the bottom of the symbol table. 

The format of the .MEMI command is: 

ACO - NMAX increment or decrement : 

.SYSTM 
.MEMI 
error return 
normal return 

AC1 - New NMAX. 
There is one error which may result from a .MEMI command: 

AC2 Mnemonic Meaning 

26 ERMEM Attempt to overwrite the binary loader. 

SYSTEM RETURN COMMANDS 

These calls return control to their error returns unconditionally. 

System Return (. RTN) 

This command stops all tasks (except the caller), closes all channels, and 
returns control unconditionally to the error return; no normal return is reserved. 
The format of the . RTN command is: 

.SYSTM 
.RTN 
error return 

The following error code is returned: 

AC2 Mnemonic Meaning 

23 ERRTN Attempt to restore a nonexistent image (as in RDOS). 
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System Error Return (. ERTN) 

This command stops all tasks (except the caller), closes all channels, and returns 
control unconditionally to the error return; no normal return is reserved. The 
format of the .ERTN command is as follows: 

.SYSTM 
.ERTN 
error return 

The following error code is returned in AC2: 

AC2 Mnemonic Meaning 

23 ERRTN Attempt to restore a nonexistent image (as in 

RDOS). 

CLOCK AND CALENDAR COMMANDS 

RTOS clock and calendar commands may be used in any system which includes a 
real time clock. RTOS clock and calendar commands permit ready tasks to be 
suspended for a period of time, permit the system real time clock to be examined, 
and allow the creation of a user clock to specify a recurring interruption of 
multitask activity. 

Delay the Execution of a Task (. DELAY) 

This command suspends the caller for a specifiable number of pulses of the system 
real time clock. Thus this command permits the creation of a time slicing facility 
within RTOS. The system real time clock frequency is set when a system is 
generated, and no system call can alter this frequency. 

The format of the .DELAY command is: 

ACi - Number of RTC pulses in the delay period. 

.SYSTM 
. DELAY 
error return 
normal return 

Contents of ACI are lost upon return. One possible error may occur: 
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Delay the Execution of a Task (. DELAY) (Cantiw^rW 

AC2 Mnemonic Meaning 

2 ERICM Illegal system command (i. e. , no RTC in system). 

Get Today's Date (.GDAY) 

This command requests the system to return the number of the current day, month, 
and year. The day is returned in AGO, 
The format of the .GDAY command is: 



and vear. The dav is renirn^rl in Ann. Hip mnnfh in Afl anri nSo imar in Am nrv,,. 



• SYSTM 
.GDAY 
error return 
normal return 

ACO - Day of the month. 
AC1 - Month of the year. 
AC2 - Year. 

The error return is never taken. 
Set Today's Date (.SPAY) 

This command permits the system calendar to be set to a specific date. The system 
will increment the date when the time of day passes 23 hours, 59 minutes, and 59 
seconds. The caller passes the number of the day within the month in ACO, the 
number of the month in AC1 (January is month number 1), and the current year in 
AC2. The format of the .SDAY command is: 

ACO - Day of the month. 
AC1 - Month of the year. 
AC2 - Year. 

.SYSTM 
.SDAY 
error return 
normal return 

One possible error return is: 

AC2 Mnemonic Meaning 

41 ERTIM Illegal day, month or year. 
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Get the Time of Day (. GTOD) 

This command requests the system to pass the current time in hours, minutes 
and seconds to the caller. The format of the .GTOD command is: 

.SYSTM 
.GTOD 
error return 
normal return 

ACO - Second. 

AC1 - Minute. 

AC2 - Hour (using a 24 -hour clock). 

No error return is possible. 

Set the Time of Day (.STOP) 

This command permits the caller to set the system clock to a specific hour, 
minute, and second. The format of the .STOD command is: 

ACO - Second. 
AC1 - Minute. 
AC2 - Hour (using a 24-hour clock). 

.SYSTM 
.STOD 
error return 
normal return 

If the error return is taken, the following error code is given: 

AC2 Mnemonic Meaning 

41 ERTIM Illegal time of day. 

Examine the System Real Time Clock (.GHRZ ) 

This system call permits the caller to examine the frequency of the real time 
clock (the frequency was set when the RTOS system was generated). One of 
five frequency codes is returned in ACO, as described below. The format of the 
.GHRZ command is: 
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Examine the System Real Time Clock (.GHRZ) (Continued) 

.SYSTM 
. GHRZ 
error return 
normal return 

ACO: - there is nn tpaI rim<=> rln^V in the* av?t""i 

1 - the frequency is 10HZ. 

2 - the frequency is 100HZ. 

3 - the frequency is 1000HZ. 

4 - line frequency is 60HZ. 

5 - line frequency is 50HZ. 

The error return is never taken. 
Define a User Clock (.DUCLK) 

This command permits the definition of a user clock. When the user -defined 
interval expires, the task scheduler and multitask environment- -if any- -are 
placed in suspension, and control goes to a user -specified routine outside the 
task environment. No task calls (other than . UCEX and . IXMT) may be issued 
from this interrupt routine, since multitask activity is in suspension. Only one 
user clock may be defined at any one moment. 

The format of the .DUCLK command is: 

ACO - Number of RTC pulses during each user clock interval. 
AC1 - Address of user interrupt routine. 

.SYSTM 
.DUCLK 
error return 
normal return 

Only one error condition is possible: 

AC2 Mnemonic Meaning 

45 ERIBS A user clock already exists. 
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Exit from a User Clock Routine (.UCEX) 

Upon a user clock interrupt, AC3 will contain the address of the return upon 
entry to the routine specified in .DUCLK. To return from the user clock routine, 
AC3 must be loaded with the return address that it contained upon entry to the 
routine, and task call .UCEX must be issued. 



The format of this call is: 

AC3 - Return address upon entry to routine. 

.UCEX 

Control returns to the point outside the user routine which was interrupted by 
the user clock. No errors are possible from this call. This call can be issued 
in a single task environment. 

Remove a User Clock (.RUCLK) 

This system command removes a previously defined user clock from the system. 

The format of this call is: 

.SYSTM 
. RUCLK 
error return 
normal return 

The error return is never taken. 



**** 
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CHAPTER 3 
TASK CALLS 



The following is a list of all RTOS task call mnemonics: 



. ABORT 

. AKILL 

.ARDY 

.ASUSP 

.IDST 

.IXMT 

.KILL 

.PRI 

.REC 

• SUSP 
.SMSK 
.TASK 
.TIDK 
.TIDP 
.TIDR 
.TIDS 
.UCEX 

• UIEX 

• UPEX 
.XMT 

YMTW 



Terminate a task immediately. 
Kill all tasks of a specified priority. 



RpaHv all faalra r»f a ona/~if iai-I .,, 



Suspend all tasks of a specified priority. 

Get a task's status by I.D. number. 

Transmit an interrupt message. 

Kill the calling task. 

Change the calling task's priority. 

Receive a task message. 

Suspend the calling task. 

Modify the current interrupt mask. 

Create a task. 

Kill a task specified by I. D. number. 

Change the priority of a task specified by I. D. number. 

Ready a task specified by I. D. number. 

Suspend a task specified by I. D. number. 

Exit from a user clock routine. 

Exit from a user interrupt routine. 

Exit from a user power fail routine. 

Transmit a task message. 

Transmit a task message and wait for its receipt. 



All RTOS task calls except .SMSK, .UCEX, .UIEX and .UPEX are described in 
this chapter in alphabetical order. . UCEX is found in Chapter 2, and the 
remaining task calls are described in Chapter 4. 

Abort a Task (.ABORT) 

The . ABORT task call causes a specified task to be readied immediately and to 
execute the equivalent of a .KILL task call as soon as it gains control of the CPU. 
The exact time of completion of the . KILL is dependent on the priority of the 
aborted task relative to other ready tasks. For example, a task attempting to 
perform a write sequential of 500 bytes might be aborted after writing any 
number of bytes. The task which is to be aborted is specified by I. D. number. 
Thus the caller may abort either itself or some other ready or suspended task.' 
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Abort a Task (.ABORT) (Continued) 

Outstanding operations performed by the task, like waiting for a message trans- 
mission/reception (. XMTW/. REC), are terminated. Likewise, all system calls 
are aborted with the exception of calls performing QTY or MCA I/O, QTY and 
MCA I/O can be aborted by closing their channel(s) with a . CLOSE or . RESET 
system command. 

The format of this call is as follows: 

AC1 - I. D. of the task to be aborted. 

.ABORT 
error return 
normal return 

The contents of ACO is lost upon return. 

The error return is taken under one of two conditions: 

AC2 Mnemonic Meaning 

61 ERTID An I. D. of zero was specified, or no such task I. D. was 

found. 
110 ERABT The specified task was performing QTY or MCA I/O. 

Kill All Tasks of a Specified Priority (.AKILL) 

This command deletes all tasks with a priority given in ACO. The calling task 
itself may be deleted by this command. All tasks that are killed have their TCB's 
placed in the free element TCB chain. If an attempt is made to kill a task which is 
suspended due to an outstanding .SYSTM call, that task will be killed at the com- 
pletion of the .SYSTM call. Tasks suspended by .XMTW, .REC, .TIDS, or .SUSP 
will also be killed. 

The format of this call is: 

ACO - Task priority. 

.AKILL 
normal return 

There is no error from this call. If no tasks exist with the priority specified in 
ACO, no action is taken. If all tasks become deleted, the effect is to close all the 
channels and to idle the system, since control returns to the task scheduler. 
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Ready All Tasks of a Specified Priority (.ARDY) 

This call readies all tasks which were previously suspended by .ASUSP (.SUSP 
or .TIDS) whose priority is specified in ACO. That is, bit 1 in word TPRST of 
each TCB (see Chapter 5) that was set by a previous call to .ASUSP, .SUSP, or 
• TIDS is now reset. Tasks suspended for other reasons too (e.g. , outstanding 
system calls) will only be readied when the task is fully ready, i.e. , bits 
and 2 are also reset. The format of this call is: 

ACO - Task priority. 

.ARDY 
normal return 

There is no error return from this call. If there are no tasks with the priority 
specified in ACO, no action is taken and control goes to the normal return. 

Suspend All Tasks of a Given Priority (. ASUSP) 

This command suspends all tasks with the priority given in ACO. The calling task 
itself may be suspended by this call. All tasks suspended by . ASUSP (including 
those additionally suspended for other reasons such as an outstanding system call 
or waiting for a task message transmission) will remain suspended until readied 
by an . ARDY or . TIDR command. 

The format of this call is: 

ACO - Task priority. 

. ASUSP 
normal return 

There is no error return from this call. If no tasks exist with the given priority, 
no action is taken and control goes to the normal return. 

Get a Task's Status (. IDST) 



This command obtains a code describing a task's status. The task whose status 
is to be obtained is specified by inputting its identification number in AC1. The 
format of this call is: 

AC1 - Task I. D. number 

.IDST 
normal return 
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Get a Task's Status ( . IDST) (Continued) 
The code describing the task's status is returned in ACO: 

- Ready. 

1 - Suspended by a . SYSTM call. 

2 - Suspended by a . SUSP, . ASUSP, or . TIDS. 

3 - Suspended by . XMTW or . REC. 

4 - Not used. 

5 - Suspended by . ASUSP, . SUSP, or . TIDS and by . SYSTM. 

6 - Suspended by . XMTW or . REC and by . SUSP, . ASUSP, or . TIDS. 

7 - Not used. 

10- No task exists with the specified I. D. number. 

There is no error return from this call. 

Transmit a Message from a User Interrupt Service Routine (. IXMT) 

Whenever a device requiring special user service generates an interrupt request, 
(see Chapter 4), the entire task environment becomes frozen until servicing of the 
special user interrupt is completed. All tasks will resume their former states 
when the environment is restarted unless the user transmits a message to one of 
them by means of the . IXMT call from the interrupt service routine. In the latter 
case? rescii6uUxing occurs Wnen tue tasic environment is restarteu. 

If the task for which the non-zero message is intended has issued a . REC for the 
message, the task state is changed from suspended to ready even though task 
activity is in suspension. If more than one task is awaiting a message at this 
location, only one will receive the message and be readied. Contents of all 
accumulators are destroyed upon return from . IXMT, so the user is cautioned to 
restore AC2 and AC3 before attempting an exit from the service routine. 

As with . XMT (described later in this chapter), . IXMT causes a non-zero message 
to be deposited in a location. The contents of this location must be zero at the time 
. IXMT is invoked, or else the location will be deemed to be already in use. 



ACO - Message location. 
AC1 - Message. 

.IXMT 
error return 
normal return 
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Transmit a Message from a User Interrupt Service Routine (. IXMT) (Continued) 

The error return is taken if the message address is already in use (i. e. , if its contents 
are non-zero). 

AC 2 Mnemonic Meaning 

43 ERXMT Message location is in use. 

Delete a Calling Task (.KILL) 

This command deletes the calling task's TCB from the ready queue and places it in 
the free element TCB chain. The calling task is the only task that may be deleted 
via this command. 

The format of this call is: 

.KILL 

There is no return from this call. Control goes to the task scheduler. 

Change the Priority of a Task (. PRI) 

This command changes the priority of the calling task. The calling task will be 
assigned the lowest position in the new priority class. That is, equal priority 
tasks receive control on a round-robin basis, and this task will be the last task 
in this priority class to be allocated CPU control by the scheduler. 

The format of this command is: 

ACO - New task priority. 

.PRI 

normal return 

There is no error return from this command. If a priority greater than 255 is 
requested, only the value in bits 8 through 15 will be accepted. 

Receive a Message (.REC) 

This command returns a message in AC1 that another task or interrupt service 
routine has posted by means of a transmit command, and restores the contents 
of the message location to all zeroes. Only one task at a time can receive a 
message from a given location. 
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Receive a Message (.REC) (Continued) 

If the transmitter has not yet posted a message for the receiving task, the receiver 
becomes suspended until the message is issued. If the message has already been 
issued and if the task has not also been suspended by some other event, control 
returns to the task scheduler. 

The format of this command is: 

ACO - Message address. 

.REC 

rinrmql rotirrn 

AC1 - Message. 

There is no error return from this command. 

Suspend a Task (.SUSP) 

This command places the calling task in the suspended state by setting bit 1 of the 
task's status and priority word. The format of this call is: 

.SUSP 
normal return 

There is no error return. The suspended task remains suspended until it is readied 
by an .ARDY or .TIDR command. 

Create a Task (.TASK) 

This command creates a new task in the user environment, and assigns to it a 
TCB from the TCB pool allocated during system generation. This command creates 
a task at a specified priority and assigns a unique identification number (I. D. ) 
to the task, if desired. When the user program is started, only one task (the 
default task) exists. Thus this command is used to start up a multitask environment. 

The new task can be assigned any priority from through 255 decimal, and any 
task I. D. in the same range. If the priority input to this command is 0, the 
priority of the caller will be assigned to the new task. More than one task with 
an I. D. of zero can exist. This call will pass to the new task the contents of the 
caller's AC2; thus this accumulator can be used for relaying an initial one-word 
message to the newly created task. 
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Create a Task (. TASK) (Continued) 

The format of this command is: 

ACO, left byte - New task's I. D. 

ACO, right byte - New task's priority. 

AC1 - New tasjc's starting address. 

AC2 - Caller's AC2 passed to the new task. 

.TASK 
error return 
normal return 

If the error return is taken, AC2 will contain one of the following error codes: 

AC2 Mnemonic Meaning 

42 ERNOT No TCB's available. 

61 ERTID Same I. D. number (except 0) already assigned. 

Kill a Task Specified by I. D. Number (. TIDK) 

This call kills only that task whose identification number is specified in AC1. 
The format of this command is: 

AC1 - I. D. of task to be killed. 

.TIDK 

error return 
normal return 

If the error return is taken, AC2 will contain the following error code: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 

Change the Priority of a Task Specified by LP. Number (. TIDP) 

This command changes the priority of that task whose identification is specified by 
the contents of AC1. The new priority to be assigned to the task is given in ACO, 
bits 8 to 15. Thus the format of this task call is as follows: 

ACO, right byte - New priority. 

AC1 - I. D. of task whose priority is to be changed. 
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Change the Priority of a Task Specified by I. D. Number (. TIDP) (Continued) 

.TIDP 

error return 
normal return 

If the error return is taken, the following code is given: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 

Ready a Task Specified by I. D. Number (. TIDR) 

This command readies only that task whose identification number is input in AC1. 
That is, this command resets bit 1 in TPRST of this task's TCB which was set by 
a previous call to .ASUSP, .SUSP, or .TIDS. The format of this call is: 

AC1 - I.D. of task to be readied. 

.TIDR 

error return 
normal return 

If the error return is taken, AC2 will contain the following error code: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 

Suspend a Task Specified by I.D. Number (.TIPS) 

This command suspends only that task whose identification number is input in AC1. 
That is, this call sets bit 1 in word TPRST of the specified task's TCB. The format 
of this command is: 

.TIDS 

error return 
normal return 

If the error return is taken, AC2 will contain the following error code: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 
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Transmit a Message (.XMT), and Wait (.XMTW) 

These two calls permit the sending of a one-word non-zero message by one task 
to an empty (all -zero) message location for another task. The difference between 
these commands is .XMT simply causes the message to be deposited, while 
.XMTW deposits the message and suspends the caller until the message is received. 
. XMTW will not cause the caller to be suspended if a . REC has already been 
issued for this message. 

The format of this call is: 

ACO - Message address. 
AC1 - Message. 

.XMT (or .XMTW) 
error return 
normal return 

The error return is taken if the message address is already in use (i. e. , if the 
contents are non-zero). AC2 will then contain the following error code: 

AC2 Mnemonic Meaning 

43 ERXMT The message address is already in use. 
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CHAPTER 4 

USER INTERRUPTS AND POWER FAIL /AUTO RESTART PROCEDURES 
SERVICING USER INTERRUPTS 

User devices may be identified either at the time an RTOS system is generated 
(RTOSGEN time) or at run time. This chapter describes the procedure for 
identifying a user device at run time, and describes the special considerations 
applying to special, high priority user interrupt devices. 

Upon detection of an interrupt request, the system will be dispatched through the 
device interrupt vector table, . ITBL . In this table are pointers to Device Control 
Tables (DCTs) for devices established at RTOSGEN time, whether system or user 
devices. Procedures for writing a device driver for insertion in the system at 
RTOSGEN time are given in DGC application note 017 -000006, User Device Driver 
Implementation in the Real Time Operating System. 

In order to identify a user device to the system at run time, the user must provide 
a three -word DCT as an interface between the system interrupt dispatch routine 
and the user -interrupt servicing routine. The structure and mnemonic assignments 
of this three-word table are as follows: 

Displacement Mnemonic Purpose 

DCTSV Pointer to the state save area (an 8^word 

area). 

1 DCTMS Interrupt service mask. 

2 DCTIS Interrupt service routine address. 

DCTSV is a pointer to an eight-word state variable save area used by the system to 
store the PC, accumulators, carry, etc. DCTIS is a pointer to the routine which 
services this particular device interrupt. DCTMS is the interrupt mask * that the 
user wants to be ORed with the current interrupt mask while in the user interrupt 
service routine. This mask establishes which devices --if any--will be able to 
interrupt the currently interrupting device. 



See "How to Use the Nova Computers, " Section 2.4, 
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SERVICING USER INTERRUPTS (Continued; 

Upon transferring control to the user interrupt service routine, the system will 
ensure that AC3 contains the return address required for exit from the routine, 
and that AC2 contains the address of the DCT. (Caution: RDOS 03 does not place 
the DCT address in AC2. ) Exit is accomplished by issuing task call . UCEX; 
this call mav be issued in both single and multitask environments. 

All multitask environment activity ceases at the moment a user device interrupt is 
detected. Nonetheless, it is possible for a user to communicate a message to 
a task from a service routine. If the task in question has been expecting such a 
message through issuance of a .REC and is now in the suspended state, issuance 
of the message via . IXMTwill cause that task to be readied even though multi- 
task activity is in abeyance. If no task has issued a . REC for such a message, 
. IXMT simply posts the message and takes no further action. For more information 
on communicating to tasks from a user interrupt service routine, see Chapter 3. 

Identifying User Interrupt Devices (. IDEF) 

In order to introduce to the system those devices (not identified at RTOSGEN time) 
whose interrupts the system is to recognize, the system call .IDEF must be issued. 
This call places an entry in the device interrupt vector table, . ITBL . Required 
inputs to this call are the device code of the user device and the starting address 
of this device's DCT. The format of this call is: 

ACO - Device code of the user device. 

AC1 - Starting address of the user device's DCT. 

.SYSTM 
.IDEF 

error return 
normal return 

Possible error messages are: 

AC2 Mnemonic Meaning 

36 ERDNM Illegal device code (>77g). Device code 77g is 

reserved for the power monitor/auto restart 
option. 

45 ERIBS Interrupt device code in use. 

Exit from a User Interrupt Routine (. UIEX) 

Upon a user device interrupt, AC3 will contain the return address upon entry to the 
user routine and AC2 will contain the DCT address. To return from the user 
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Exit from a User Interrupt Routine (. UIEX) (Continued) 

interrupt routine, AC3 and AC2 must be restored to the values they contained upon 
entry to the routine, and task call. UIEX must be issued. (Caution: RDOS 03 will 
execute this call correctly without the DCT address in AC2. ) 

The format of this call is: 
AC2 - DCT address. 
AC3 - Return address upon entry to routine. 

.UIEX 

Control returns to the point outside the user routine which was interrupted by the 
user device. No errors are possible from this call. This call can be issued in a 
single task environment. Rescheduling occurs only if a task state change occurred. 

Modifying the Current Interrupt Mask (.SMSK) 

Whenever a user interrupt occurs, the interrupt mask is ORed with the mask 
contained in DCTMS of the user DCT to produce the current interrupt mask. 
Nonetheless, it is possible in the service routine to produce a current mask which 
ignores the contents of DCTMS, producing a new mask which is the logical OR of 
the old mask (upon entry to the service routine) and a new value. This is done by 
task call .SMSK, whose format is as follows: 

ACO - New value to be ORed with old mask. 
AC2 - DCT address. 

.SMSK 

normal return 

There is no error return possible from this call. This call may be issued in a 
single task environment. (Caution: RDOS 03 will execute this call correctly without 
the DCT address in AC2.) 

Remove User Interrupt Servicing Program (. IRMV ) 

To prevent the system's recognition of user interrupts which have been previously 
identified by the . IDEF command, the . IRMV command is issued. Required input 
to this call is the user device code corresponding to the device control table which 
is to be removed. The format of this call is: 

ACO - Device code. 

.SYSTM 
.IRMV 
error return 
normal return 
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One possible error message may be given: 

AC2 Mnemonic Meaning 

36 ERDNM Illegal device code ( > 77 ) or attempt to remove 

a system device ( i. e. , one established at RTOSGEN 
time). 

POWER FAIL/AUTO RESTART PROCEDURES 

RTOS provides software support for the power fail/automatic restart option. Upon 
detection of a loss of power, the system transfers control to a power fail routine 
which saves the status of accumulators through 3, the PC and Carry. 

When power is restored, if the console key is in the LOCK position, the message 

**POWER FAIL** 

is output on the system console and the state variables are restored before control 
resumes operation at the point where it was interrupted. If the console key was in 
the ON position when input power failed, the user must set the console switches to 
all zeroes (down} and START mnst W> n-r^se^r! wVi»n mwor ic ™^ n «.ri ti,^ -o,,^,- 

the console message to be output and state variables to be restored as when the key 
is in the LOCK position. 

The following system devices are given power-up restart service: 

paper tape readers /punches 

Teletypes 

quad multiplexors 

card readers 

line printers 

disks 

Character devicPS msv lnsp> nnp mr mm-P rha-rsintt=rc Hm-TTirr twiirov im !?.-»,-.%. r*^-~A 

reader may lose up to 80 columns of information on a single card. Line printers 
may lose up to a single line of information. Since power up service for disks 
includes a complete re-read or re-write of the current disk block, no disk 
information is lost, although moving head disk units will require 30 to 40 seconds 
before disk operations can continue. Devices requiring operator intervention (like 
line printers, card readers, etc. ) must receive such action if power was lost for 
an extended period of time. No power up service is provided for magnetic tape 
or cassette units. 
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POWER FAIL/AUTO RESTART PROCEDURES (Continued) 

Power up service for special user devices (or for magnetic tape or cassette units) 
must be provided by the user via the system call . IDEF . To use . IDEF for this 
purpose, ACO must be input with 77g and AC1 must input the starting address of 
the user power up routine. Exit from this power up routine is accomplished by 
task call .UPEX, described below. 

Exit from a Power Fail Service Routine (. UPEX) 

Upon entering a user power fail service routine, AC3 will contain the address 
required for exit from the routine. To return from the user power fail service 
routine, AC3 must be loaded with this return address and task call . UPEX must 
be issued. 

The format of this call is: 

AC3 - Return address upon entry to the routine. 

.UPEX 

Control returns to the location which was interrupted by a power failure. No 
error return or normal return need be reserved. .UPEX can be issued in a 
single task environment. 

HIGH PRIORITY USER INTERRUPT SERVICE 



As described in Chapter 6 and in Appendix B, special high priority interrupt 
devices may be incorporated into an RTOS system at RTOSGEN time. The real 
time clock and power fail/auto restart device are two such high priority interrupt 
devices; users may also specify custom high priority interrupt service routines. 

All high priority devices have entries in a high priority interrupt dispatch table, 
. HINT . Entries in this table are scanned whenever an interrupt occurs, and only 
if no high priority device has caused an interrupt will control branch through the 
normal interrupt table, . ITBL . All other system devices, and user devices 
announced at run time (via system call . IDEF), have entries in . ITBL . 

Interrupts are disabled whenever high priority interrupt service is being performed. 
Users writing high priority interrupt service routines must also conform to several 
programming conventions. In general, these conventions are as follows: 
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HIGH PRIORITY USER INTERRUPT SERVICE (Continued) 

1) Issue no task or system calls. 

2) Save and restore accumulators and Carry if used by this routine. 

3) Save the contents of location 0, and place a HALT instruction in 
location (optional). 

The state of Carry and the contents of accumulators ACO through AC2 must be saved 
within this routine if they are altered in this routine, and these state variables must 
be restored before leaving the routine. AC3 is saved by the system in location . SAC 3 
(a location within module INTD), and AC3 too must be restored before exit is accom- 
plished even if the routine didn't use AC3. The contents of location will contain 
the return address needed for exit; this address should be stored in a user-provided 
location, e. g. , RET , and a HALT instruction should be stored in location 0. This 
practice is adhered to by RTOS to capture program control in the event of system 
failure. 



The final two instructions which must be executed when leaving a high priority 
interrupt service routine are to enable interrupts and then to perform an indirect 
JMP to the location containing the original return PC, e.g. , RET . Control will 
then pass to the next instruction which would have been executed had no high 
priority interrupt occurred. The following instruction sequence accomplishes 
these operations. 

.EXTN .SAC 3 

; RESTORE ACO, AC1, AC2, CARRY 





LDA 3 @ SAC3 




INTEN 




JMP @ RET 


SAC3: 


.SAC3 


RET: 


.BLK 1 




.END 
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CHAPTER 5 

MULTIPLE PROCESSOR SYSTEMS 

MULTIPLE PROCESSOR PROGRAMMING 

All features of RTOS discussed in previous chapters are available to systems with 
two or more processors. Additional hardware support extended to multiple pro- 
cessor systems by RTOS is in the form of a Multiprocessor Communications 

Arioi->f-o-i- fT\ACA\ /~.i-\<-i^>t-, A n Q Q 

Data Transmissions 

The type 4038 Multiprocessor Communications Adapter receiver /transmitter 
(MCAR/MCAT) makes it possible for full duplex interprogram communications to 
take place, in blocks of up to 8192 bytes, via the data channel. MCA support can 
be given to a single processor in a multiple processor system so that an RTOS 
program running in one processor can communicate with an RTOS program 
running in another processor or with either a foreground or background program 
running under RDOS in another processor. Each CPU may communicate with any 
of up to 14 other CPUs. 

Each MCA line corresponds to a file name of the following form: 

MCAT:mm or MCARmn 

where mm represents a receiver unit number from 1-15 inclusive and where nn 
represents a transmitter unit number in the range - 15. Thus a four-CPU, RTOS- 
only system would be logically configured with 10 separate lines if every possible 
communications link were to be used. 
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Data Transmissions (Continued) 

If CPU #1 wanted to read from CPU #3, each unit would have to issue the following 
sets of instructions: 

Unit #1 Unit #3 



. OPEN n ;OPEN MCAR:3 . OPEN n ;OPEN MCAT:1 
.RDSn .WRSn 

Note that units #1 and #3 are operating under distinct operating systems. Thus, 
in the illustration on the previous page there is no correspondence between channel 
n for unit #1 and channel n for unit #3. 

If , in a receive request, unit number zero is specified to be the transmitter (e. g. , 
MCAR:0), the receive request becomes generalized to indicate that any unit may 
transmit to this receiver. Thus if unit #1 had three outstanding receive requests, 
MCAR:4, MCAR:3, and MCAR:0, it could receive concurrent transmissions from 
three sources: a transmission unit from unit #4, a transmission from unit #3, and 
a message from any other unit that chose to transmit to it. 

A rimpmif car nrrnr nnl-ir in Ao AACA t-r-onomit-fro^-- t-Un i-n/.m'.mi. ^o^i ,,,„,'*- ;„^„e:„i t — i„ 
-- " ~"~~~- ~-~.n. ww*, UJi _ ui^ "i ui^, J.V4.W4*. t.xuaioiiixi.t.^j. , cij.v_. iv,^tiv^x v^clii wan iaiwciJ-iiiLC-ty • 

The timeout period ranges from approximately 10 milliseconds to approximately 
655 seconds. The default timeout, specified at RTOSGEN time, may be super- 
seded by specifying a different timeout both when the transmitter is opened and 
when the write sequential is issued. 

Get the Current CPU's MCA Number (. GMCA) 

It is possible to get the MCA unit number in the CPU which is currently executing a 
user program. To obtain the unit number, system call . GMCA is issued. The 
format of this command is as follows: 

.SYSTM 
. GMCA 
error return 
normal return 

If the normal return is taken, the MCAunit number is returned in ACl. If the error 
return is taken, the following error code will be input in AC2 : 

AC2 Mnemonic Meaning 

36 ERDNM Device not in system (i. e. , no MCA was specified 

at SYSGEN time in this operating system). 
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MULTIPROCESSOR SYSTEM ILLUSTRATION 

Consider the following application for a multiprocessor system. A large labora- 
tory complex needs an automated system to control the environmental conditions 
within the complex, to keep track of the number of personnel at locations through- 
out the complex, and to monitor the complex for alarm conditions (alerting key 
personnel when a condition cannot be corrected by the system itself). Moreover, 
the system must be fail-safe, and can allow down-time for no longer than a few 
seconds. 

Such a system might well be configured along the lines suggested by the illustration 
at the end of this section. Two master CPUs, a Dual Nova system running under 
RDOS, are connected in redundant fashion so that if one fails, the other detects 
this failure and gains immediate control. The masters access a common data base 
which contains, among other information, alarm messages and destinations to 
which they should be sent in the event of an alert. Also contained in this file space 
is a log of the current master's activity, so that if it should experience failure, 
the alternate master CPU would have a record of recent events. An IPB connects 
the masters so that they may access common disk files and so mat one may act as 
a watchdog on the other's behavior. 

There are three slave CPUs, each of which monitors and controls various para- 
meters within one zone of the building complex. Each slave is capable of monitor- 
ing and adjusting both the humidity and the temperature of each zone. Additionally, 
each slave keeps track of the positions of personnel within each zone. Finally, 
each slave monitors its zone for the occurrence of alarm conditions, and it can 
perform limited response to emergencies, e.g. , it can activate a sprinkler system 
if fire is detected. The functions performed by each slave are relatively simple 
and could be performed by Nova 2's running under RTOS. 

Each slave has a high speed data channel line, MCA1 through MCA6, to each of the 
two master computers, so that continuous status reports can be generated by them 
for transmission to CRT monitors via the Multiline Asynchronous Controller, MAC. 
The MAC also has direct "hot lines" to key personnel (security guards, fire 
station personnel, etc. ) who should be alerted in the event of an emergency. 
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CRT 
and 
"Hot Lines" 




Zone 1 



Zone 3 



Zone 2 



a 
b 
c 

a 



temperature sensing and control 
census taking 

humidity sensing and control 
intrusion/fire/smoke alarm and control 



Ml - Master CPU 

M2 - Back-up Master CPU 

S1,S2,S3 - Slave CPUs 



MULTIPROCESSOR SYSTEM ILLUSTRATION 
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CHAPTER 6 



SYSTEM ORGANIZATION 



This chapter describes the collection of tables and fixed locations which are used by 
programs running under the real time operating system. As described in Appendix 
C, each user program supported by RTOS is loaded with an RTOS module generated 
by the RTOSGEN program, followed by user- supplied RTOS drivers and the RTOS 
system library. Loading itself is accomplished by means of the stand-alone or SOS 
extended relocatable loader or the RDOS loader. At the completion of loading, 
pointers and tables are found as illustrated in the RTOS Core Map shown on the 
following page. 

RTOS Page Zero 

Locations through 15 are reserved for use by the system and cannot be taken 
by user programs. Location receives the current PC upon each interrupt, and 
location 1 contains a pointer to the system interrupt dispatch logic. This is usually 
either . HINT, the high priority interrupt dispatcher, or . INTP, the regular interrupt 
processor. These modules are produced by RTOSGEN. 

When a task in RTOS is in the executing state, the CPU is said to be in User Mode. 
Otherwise (as when RTOS is engaged in some system function like task scheduling) 
the CPU is said to be in System Mode. Location 5, .SYS. , is a flag which is set 
to zero when the system is in User Mode, and is set to non-zero in System Mode. 
Interrupts in a real-time environment occur randomly. Since it is inappropriate 
for certain interrupt -triggered system functions to be reentrant (e.g. , task 
scheduling) .SYS. serves as an interlock to prevent undesired entries into these 
routines. 

Location 2, BEGIN, contains a pointer to the RTOS initialization program. This 
program is used to initialize stacks and clear switches in RTOS. The first section 
of this routine zeroes system switches and intializes all device handlers. The 
starting task is initially set to a priority of zero, the hardware interrupt mask is 
made zero, the system is set in User Mode (.SYS. = 0), the real time clock is 
started, and TCB chain pointers are initialized. The wait character logic, 
activated by . WCHAR, is also reset. 



The last operations performed by the initialization program are to enable the 
interrupt facility by the INTEN instruction, and to jump to the start of the user 
program (which must have been specified in an . END statement). 

6-1 



RTOS Core Map 



Page Zero 
1 

2 BEGIN 

3 CTCB 

4 SCHED 

5 .SYS. 

6 RLOC 

7 IOEND 

10 .CMSK 

11 DISMISS 

12 USTP 

13 TLINK 

14 RSCHD 

15 .TSAVE 

16 USP 
17 

20 



Contents 
Interrupt service routine address. 
Starling address for system initializer. 
Address of currently executing task's TCB. 
Entry point to task scheduler. 
System mode indicator. 

Page zero temporary. 

Entry point to I/O end processor. 

Current system interrupt mask. 

Interrupt dismissal address. 

Reserved for RDOS/RTOS compatibility; set to 400. 

Entry point to routine linking ready TCB to TCB chain. 

Entry point to reschedule the system. 

Address of TCB state save routine. 

User Stack Pointer (USP). 

Entry point to system call processor. 

First page zero location available to user program. 



Page One 
400 UST 
426 
440 

.TCBP 
.UFPT 
.DTBL 

.PTBL 

.QTBL 

.MCTB 

.HINT 

.ITBL 

.ETBL 

.CHTB 



Start of User Status Table. 

End of User Status Table. 

Beginning of NREL area into which RTOS and user modules may be loaded. 
The following global symbols may be present in the RTOS modules : 

Start of TCB pool (total length = no. of TCBs*12.J. 

Start of User File Pointers Table, UFPT (total length = no. of channels *2). 

Start of fixed head disk table, DTBL (total length = 1 + 5 "number of disk 
files defined at RTOSGEN time). 

Start of moving head disk table, PTBL (total length = 1 + 6*number of disk 
files defined at RTOSGEN time). 

Start of 4060 asynchronous multiplexor (QTY) table, QTBL (total length 
= 10 *number of QTY lines). 

Start of Multiprocessor Communication Adapter line table, (total length 
= 7 + number of adapters in the network *14 ). 

Start of high priority dispatcher (length = 1 1 + 3 "number of high 
priority interrupt devices). 

Start of interrupt table, ITBL (64 words long). 

End (last location) of ITBL (user power fail handler, if present). 

Start of device name table, CHTB (length = 1+4 "number of devices in system). 

User program with user device drivers, if any. 

RTOS device drivers. 

RTOS system library modules. 
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Location 3, CTCB, contains the TCB address of the currently executing task. Location 
4, SCHED, points to the main entry in the task scheduler. This entry causes the 
highest priority ready task (if any) to be executed. Location 14, RSCHD, points to 
an alternate entry in the scheduler. This entry links the currently executing task's 
TCB to the ready chain, then transfers control to the entry pointed to by SCHED . 

Location 6, RLOC, is a temporary location used by RTOS; location 7, IOEND, is 
— ^*_uj, yu^ it ^ Ult i/w ciiu piutessur mouuie. inis routine is used to handle the 
end of I/O operations for a device handler at either the interrupt or system level. 
If while in this routine it is determined that another request is pending, the routine 
will cause the next I/O operation on the device to be started. . CMSK, location 10, 
contains the current system interrupt mask. 

DISMISS, location 11, contains the interrupt dismissal routine address. USTP, 
location 12, is reserved for use by RTOS FORTRAN, and points to the start of the 
User Status Table (location 400). The value "0400" is also equivalent to a "JMP . " 
instruction, so RTOS transfers control to this location whenever a system panic is 
detected. System panics result from unknown system errors and are generally 
unrecoverable; restarting at location 376 will restart the system provided the RTOS 
program has not been damaged. 

Location 13, TLINK, points to a routine which links a ready TCB to the ready chain. 
This routine is entered by the system whenever a task is raised to the ready state. 
RSCHD, location 14, contains the entry point to the task scheduler which links the 
current TCB to the ready chain, then executes the highest priority ready task. 
Location 15, . TSAVE, contains the address of the TCB state save routine. 

Location 16 contains the User Stack Pointer, USP . This location is used by 
FORTRAN IV and is loaded into AC3 by RTOS on return from system or task calls. 
AC3 ls destroyed whenever any such call is issued, since it is equivalent to a JSR 
instruction. On return from a call however, AC3 is loaded with the contents ofUsP. 
Thus a convenient method of saving AC3 before issuing a call is to first save AC3 
in USP. AC3 will then be restored by the system upon returning from the call. 
Furthermore, since USP is saved in the TCB as part of the state of a task in 
execution, it may be used as the equivalent of an extra register by tasks without 
stacks. 
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User Status Table (UST) 

The User Status Table (UST) is found at the start of NREL memory. This table 
is 27 words long, and contains information pertaining to the status of the user 
program. Unused words within the UST are set to -1. The structure of the UST 
is as follows: 



Displacement 


Mnemonic 





USTPC 


1 


USTZM 


2 


USTSS 


3 


USTES 


4 


USTNM 


5 


USTSA 


6 


USTDA 


7 


USTHU 


10 


USTCS 


11 


USTIT 


12 


USTBR 


13 


USTCH 



14 

15 
16 
17 
20 
21 
22 
23 
24 



25 
26 



USTCT 

USTAC 

USTFC 

USTIN 

USTOD 

USTSV 

USTSQ 

USTXQ 

USTPQ 



USTOS 
USTNA 



Contents 

Maintained for RDOS compatibility only. 

ZMAX, the lowest unused ZREL memory location. 

The start of the symbol table. 

The end of the symbol table (i. e. , its lowest 

core address). 

NMAX, the lowest unused NREL memory location. 

The user program starting address. 

The address of the debugger. 

The highest address occupied by the user program 

and RTOS upon completion of loading. 

FORTRAN common area size. 

Maintained for RDOS compatibility only. 

Maintained for RDOS compatibility only. 

Number of tasks (left half), number of channels 

(right half). 

TCB address of the first user task to execute 

after RTOS initialization. 

Start of ready TCB queue. 

Start of the free (dormant) TCB chain. 

Start of user NREL program (set by the loader). 

Reserved only for compatibility with RDOS. 

FORTRAN state- save routine. 

Start of suspended TCB queue. 

Start of the . XMTW/. REC queue. 

Start of internal system queue of tasks 

being serviced (i. e. , TCBs returning to 

base level after I/O). 

Scheduler idle counter (used in checking 

$PTR timeouts). 

Number of active tasks (TCBs in use). 



The last word in the UST is also assigned the mnemonic USTEN. 
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Task Control Block (TCB) Pool 

Following the User Status Table is found the TCB pool. This is a collection of TCBs 
which will be available to tfie user program. Each TCB is a 14 -word frame defined 
as follows: 



Contents 

Carry in bit 0, PC in bits 1-15. 

ACO 

AC1 

AC2 

AC3 

Task status and priority. 

System call word. 

TCB link word (-1 if last TCB in the queue). 

Task USP 

FORTRAN IV variables save area address. 

Task identifier. 

Used to service .ABORT calls. 

Word 5, the task status and priority, contains information describing the state of 
the task, its priority, and whether it has any outstanding message transmit or 
receive request: 



Displacement 


Mnemonic 





TPC 


i 


TACO 


2 


TAC1 


3 


TAC2 


4 


TAC3 


5 


TPRST 


6 


TSYS 


7 


TLNK 


10 


TUSP 


11 


TELN 


12 


TID 


13 


TTMP 



TPRST: 



1 2 



priority 



15 



Bit is set to a 1 if the task is suspended due to an outstanding system call. Bit 1 
is set to 1 if the task is suspended due to task calls .SUSP, . ASUSP, or . TIDS. 
Bit 2 is set to a 1 only if the task is suspended due to outstanding task calls .XMTW 
or .REC . The task priority is contained in bits 9-15. 

Word 6, TSYS, is used by RTOS in executing system calls. Word 7 contains the 
starting address of the next TCB in the queue (the last TCB in a queue has a link of 
-1). Word 12, TID, contains the task's 8-bit identifier in bits 9-15. 
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User File Pointers Table (. UFPT) 

Following the TCB pool is a table called the User File Pointers Table (.UFPT;. 
The purpose of this table is to indicate what device or file is open on which RTOS 
channels. The .UFPT consists of a series of two-word frames, one for each 
channel defined for the RTOS system at RTOSGEN time. The first frame represents 
the device (or file) opened on channel zero, etc. 

The two-word frame will contain one of two sets of information, depending upon 
whether it is a single- or multi-file device which is opened on the designated 
channel. Frames for all devices contain the device DCT address in displacement 0. 
Displacement 1 for single- file device frames is unspecified. Displacement 1 of 
multi-file device frames, however, contains a pointer to a frame within a device 
file table or within a device driver itself. Device file tables are discussed in the 
following section. Frames within device file tables describe disk files, QTY lines, 
or MCA units. Frames for cassettes and magnetic tape units point to unit control 
tables within these devices' drivers. 

Device File Tables 

One or more device file tables may follow the . UFPT. The following devices have 
special device tables and have no entries in the standard device name table (.CHTB, 
to be discussed later): 

Device Table Name 



fixed head disk . DTBL 

moving head disk . PTBL 

asynchronous mux .QTBL 

Multiprocessor Communications .MCTB 
Adapter 

£i I a f-oV\l a QofoKl i ol-idr-f -fr\ir "Pivdrl Vi£*ar\ Hiolre io r*r~\t*r\r\nc* £*r\ r\-£ a cnri £io r\f 

J.X-LW Ut*J_/-LW \_/U LC4.JJ±J.Q11^V1 1U± l.JAV.,U lJ.^UA-1 Ul^AJ J.O V^UlllJJUUUU VS.L t* *J\_ J. J. W k-J KJ A 

five^word frames, one for each file defined at RTOSGEN time. Each frame contains 
the name of the file and its contiguous disk block address boundaries. This 
approach allows four-, five-, or six-character file names to be given to each disk 
file. Disk files in RTOS will be comprised of sets of contiguous blocks on disk, 
fully compatible with contiguous disk files as defined in the real time disk operating 
system, RDOS. Each frame in .DTBL has the following structure: 
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Device File Tables (Continued) 

Displacement 
0-2 



, DTBL frame 



( 



3 
4 



Contents 

File name, left justified, trailing null 

bytes. 

Starting disk block address. 

Ending disk block address. 



The device file table for moving head disks (cartridge or pack) is similar to . DTBL, 
but has one additional entry to describe the drive unit number: 



. PTBL frame 



Displacement 


1-3 



4 
5 



Contents 

Drive unit number. 

File name, left justified, trailing null 

bytes. 

Starting disk block address. 

Ending disk block address. 



The 4060 asynchronous multiplexor driver (QTY) device table is named .QTBL . 
This table consists of a series of ten-word frames with one frame reserved for each 
QTY line; the first frame corresponds to line number 0, the second frame corres- 
ponds to line number 1, etc. Each frame in .QTBL has the following structure: 



.QTBL frame ( 



Displacement 
' 

1 
2 
3 
4 
5 
6 

7 
10 

11 



Contents 

Bit zero set if not opened; line number if 

open. 

Receive byte pointer. 

Transmit byte pointer. 

Read request TCB address. 

Write request TCB address. 

Read sequential limit; if read line. 

Write sequential limit; -1 if finished 

writing; if write line. 

Character hold for echo during read line. 

Line feed insertion flag (non-zero for 

insertions). 

Device characteristics: 

DCKEY echo characters 
DCPCK parity check/generation 
DCLAC . line feeds after carriage 
returns. 
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Device File 



;L.on:i 



; 



The device file table for MCA lines is named . MCTB . This table consists of a 
series of seven-word frames, each frame reserved for an MCA unit number; each 
MCA line connects two MCA units (a transmitter and a receiver). The total 
number of frames equals two times the number of lines defined at RTOSGEN time 
plus one (for unit number zero reception requests). The first frame corresponds 
to unit number zero, etc. Each frame in .MCTB has the following structure: 

Displacement Contents 

C List link. 

1 Word count. 

2 Current address. 

3 Device code of the adapter at the other end 
of the line; code is positioned as in the 
MCA status words. 

f ~~~~~ \ 4 Error retry count. 

3 TCB address of task issuing the read or 

write request; -1 if no task is issuing 
such a request. This word is set to zero 

if t-ha lino ic r*lr\ocwJ 

6 Device retry specification input in AC1 to 

. OPEN . 

Line table entries are linked via displacement of each frame. Entries in the 
chain correspond to MCA units which have MCA transmit or receive requests 
outstanding. 

High Priority Interrupt Table (. HINT) 

If any high priority interrupt devices were defined during system generation, one 
of two high priority interrupt dispatch tables will be loaded. If only the power fail/ 
auto restart option was selected in the RTOS system, a truncated high priority 

111LCLA UjJL UlbpaLUlCl Will JUC LUcU^CU cLLCCJ- U1C WDLUCVltC J.JJ.C Leu-lie, UUiCJ. wioc, uic 

full high priority interrupt dispatcher, .HINT, will be placed there. These 
dispatch routines are illustrated on the following page. In essence, the operation 
of .HINT is as follows. Each high priority interrupt device is examined to see if 
it generated the interrupt. The power fail monitor is tested first, then the real 
time clock, and then each of the other devices specified at RTOSGEN time in the 
order that they were specified during system generation. If the source of the 
interrupt is found, control is dispatched to its interrupt service routine; otherwise* 
control is given to the ordinary interrupt dispatcher. 
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High Priority Interrupt Table (. HINT) (Continued) 



The format of the high priority interrupt dispatcher is as follows : 



B 
A 
C 
D 



SKPDZ CPU 
JMP@ A 
STA 3@B 
INTA 3 
SKPDZ RTC 
JMP @ C 
SKPDZ device: 
JMP@D 



SKPDZ device. 

JMP@N 

JMP@ .+1 

.INTO 

.SAC3 

PWRIS 

RTC IS 

DV1IS 



n 



CHECK FOR POWER FAIL INTERRUPT 

YES, GO TO POWER FAIL INTERRUPT SERVICE. 

OTHERWISE, SAVE 3 

AND GET INTERRUPT DEVICE CODE. 

WAS IT THE REAL TIME CLOCK? 

YES. GO TO RTC INTERRUPT SERVICE 

WAS IT DEVICE 1? 

YES. GO TO DEVICE 1 INTERRUPT SERVICE 

ETC. 



GO TO DEVICE N INTERRUPT SERVICE, BUT IF 

NO HIGH PRIORITY DEVICE INTERRUPT 

GO TO ORDINARY INTERRUPT DISPATCH ROUTINE 

POWER FAIL INTERRUPT SERVICE ADDRESS 
RTC INTERRUPT SERVICE ADDRESS 
DEVICE 1 INTERRUPT SERVICE 



N: 



DVNIS 



; DEVICE N INTERRUPT SERVICE. 



The power fail - only interrupt dispatcher looks like the following: 



SKPDZ CPU 

JMP @ . +3 
JMP @ . +1 
.INTP 
PWRIS 

Interrupt Table (. ITBL) 



POWER FAIL INTERRUPT? 

YES. GO TO POWER FAIL SERVICE 

NO, GO TO ORDINARY INTERRUPT DISPATCHER 

POWER FAIL INTERRUPT SERVICE ROUTINE 



One table which is always loaded is the interrupt table, . ITBL . . ITBL is a 64 10 - 
word table which has 64 one -word frames, one for every possible device code. 
The first entry in the table corresponds to device code zero, the second entry 
corresponds to device code 1, etc. Table entries corresponding to devices in the 
system will contain the address of that device's Device Control Table (DCT). Move- 
over, if the device is a system device, bit zero of this entry will be set to one; if 
the device is a user device, bit zero will be reset to zero. 
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Interrupt Table (.ITBL) (Continued) 

The last entry in this table, the entry for device code 77g, is named . ETBL. 
entry is reserved for a user power fail /auto restart handler address. 



This 



System devices will be initialized by the RTOS initialization program .RTOS. No 
such initialization is performed for user devices. User device drivers must perform 
their own initialization. 

Standard Device Name Table (. CHTB) 

The last RTOS table which may be loaded is the name table, . CHTB. This is a 
table containing entries for single -file devices like the teletypewriter, paper tape 
reader/punch, card reader, line printer, and plotter. This table is built at system 
generation time, and consists of a series of four -word frames. 

Device entries are listed in this table in the order that the devices are found in 
. ITBL (i.e. , order is by ascending device code). The first three words of each 
frame contain the system name for the device, left justified and with trailing 
nulls. The fourth word in each frame contains the base address of the device's 



Thus a typical . CHTB would have the following structure: 



$ 


T 


T 


I 


null 


null 


TTIDC 


$ 


T 


T 





null 


null 


TTODC 







/v 







$ 


L 


p 


T 


1 


null 


LPT1DC 


-1 



i JJS % & jfc 
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APPENDIX A 



RTOS COMMAND SUMMARY 



Call 



ACO 



.ABORT 



.AKILL 



(U 



Priority of tasks to be killed. 



. SYSTM 

. APPEND n jj Byte pointer to device name. 



,(D 



. ARDY 1 1 Priority of tasks to be readied. 



,(D 



ASUSP Priority of tasks to be suspended. 



. SYSTM 
. CLOSE n 



■ ' 
. SYSTM 



, SYSTM 
.DUCLK 



Number of RTC ticks. 



. SYSTM 
. ERTN 



(2) 



.SYSTM 
. GCHAR 



. SYSTM 
. GCHN 



bits 9-15: character, 
bits 0-8: clear. 



AC1 



AC2 



I.D. of task to be aborted. 



Device characteristics mask 
(see .OPEN). 



Number of RTC ticks. 



Address of user interrupt 
routine. 



Channel number (if n = 77). 



Channel number (if n = 77). 



Data word to be placed in 
AC2. 



(returned) 

Free channel number 



(1) No error return. 

(2) No normal return. 



A-i 



Call 



AGO 



AC I 



AC 12 



. SYSTM 
. GDAY 



(returned) 
Dav. 



(rclurned) 
Month. 



(returned) 
Year. 



. SYSTM 
.GHRZ 



no RTC. 

10 HZ. 

100 HZ. 

1000 HZ. 

60 HZ (line frequency) 

50 HZ (line frequency) 



.SYSTM 
. GMCA 



(returned) 
Unit number. 



. SYSTM 
.GTOD 



(returned) 
Second . 



(returned) 
Minute. 



(returned) 

Hour (using a 24 -hr clock). 



.SYSTM 
. IDEF 



Device code. 



DCT. 



IDST 



(returned) 

0: ready. 

1: suspended by .SYSTM call. 

2: suspended by . SUSP, .TIDS, 

. ASUSP. 
3: waiting for .XMTW/.REC . 
4: not used. 
5: suspended by .SUSP, ASUSP, or 

.TIDS and .SYSTM call. 
6: suspended by . XMTW/. REC and 

. SUSP, ASUSP, or . TIDS 
7: not used. 
10: killed. 



bits 8-15: task I. D. number. 



. SYSTM 
. INIT 



Bvre nointer to device name. 



1: full init, 
0: partial init. 
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Call 



ACO 



AC1 



AC2 



| .KILL (1)(2) 


i 


; 


.SYSTM 


HMA 




NMAX 







.MEM 

i 












! 






(returned) 






.SYSTM NMAX increment or decrement 


New NMAX (after change). 






; .MEMI 


(2's complement). 












i ■ 


Channel number (if n=77). 


: -SYSTM Core data add 
'■ -MTDIOn ; transfer. 


ress, if a data j bit 0: 1, even parity; 

0, odd parity. 

i 


(Status word or system error | 
code if error return; status 
word if read status normal 


!■ 


; bits 1-3: 


return. ) 


, 


j read (words) 


1B0: 


error. 




1 rewind tape. 


1B1: 


data late. 




3 space forward. 


1B2: 


tape rewinding. 




.; 4 space backward. 


1B3: 


illegal command. 




1 5 write (words). 


1B4: 


high density or cassette 




6 write EOF. 




if 1; low density if 0. 




| 7 read device 


1B5: 


parity error. 


; 


status word. j 


1B6: 


end of tape. 




bits 4-15: 1 


1B7: 


end of file. 




word or record count, i 


1B8: 


tape at load point. 




' If on space command, j 


1B9: 


9 -track or cassette if 




position tape to new file.! 




1; 7 -track if 0. 






1B10: 


bad tape; write failure. 




: j 


1B11: 


send clock (0 if cassette) 






1B12: 


first character 
(0 if cassette). 


! 


i 1 

i 


1B13: 


write -Protected or ' 
write -locked 


\ 




IBM: 


odd character (0 if 
cassette). 




i 


1B15: 


unit ready. 

1 


. SYSTM ?yte pointer to 


. 1. 

tape Characteristic inhibit 1 


Channel number (if n = 77). 


: .MTOPDn file specifier. 


mask (see .OPEN). 






i -SYSTM Byte pointer to file name 


1B1: 80 -column device 


Channel number (if n = 77). 


. OPEN n 




1B2: lower -to -upper case 






] 






ASCII. 






! 






1B3: form feed on open. 






i; 






1B4: full word device. 












(continued on next page) ! 







(1) no error return 

(2) no normal return 
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AC1 



AC2 



.SYSTM 
.OPEKji 
(Continued) 



.SYSTM 
. PCHAR 




bits 9-15: character 



LF after CR. 
parity check/ 
generation, 
rubout after tab. 
null after FF. 
keyboard input. 
TTY output device, 
no FF hardware, 
no TAB hardware, 
leader /trailer. 
if user-specified 



MCAT timeout). 



,PRI 



(I) 



bits 8-15: new task priority. 



.SYSTM ! Starting core address to 
. RDB n receive data. 



Starting disk relative block 
number. 



bits 0-7: number of blocks 

to be read. ^ ' 
bits 8-15: channel number 
(if n = 77). ( 2 ) 



.SYSTM 
. RDL n 



Byte pointer to user core area. 



Read byte count (including Channel number (if n = 77). 

terminator) at end of read. 



.SYSTM Byte pointer to core buffer. 

. RDS n (even for MCA) 



Number of bytes to be read | Channel number (if n = 77). 
(if EOF detected, partial 
byte count returned). 



,REC 



(1) 



Message address. 



Message. 



, 1 

.SYSTM 
.RESET 

! 


.SYSTM Byte pointer to device name. 
.RLSE 


! 


(3) : 
.SYSTM ;. 

. RTN i ' 

1 ■ .,,,,, 







(1) no error return 

(2) if error EREOF, error code in bits 8-15, partial read count in bits 0-7. 

(3) no normal return 
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Call 



ACO 



AC1 



AC2 



.SYSTM 
.RUCLK 



.SYSTM 
. SDAY 



.SM3K 



New interrupt mask to be ORed 
with old mask. 



.SYSTM 
.STOD 



.SUSP 



,(D 



Second. 



T 



.TASK | bits 0-7: task I.D. 

bits 8-15: task priority. 



. TIDK 



.TIDP 



. TIDR 



.TIDS 



.iM K3) 



.UI 



m 3) 



.um m 



Month. 



Year. 



DCT address 



Minute. 



Hour. 



New task entry point 
address 



Message to new task. 



bits 8-15: task I.D. number. 



bits 8-15: task I.D. number. 



bits 8-15: task I.D. number. : 



hits 8-15: task I.D. number. 



Any non -zero value if 
rescheduling is to occur. 



Any non -zero value if 
rescheduling is to occur. 



Any non -zero value if 

rescheduling is to occur. 



DCT address 



(1) no error return. 

(2) no normal return. 

(3) return address is in AC3. 
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Call 



ACO 



AC1 



AC2 



.SYSTM -1, terminate wait request. 

.WCHAR hits 9-15: wait character. 



.SYSTM 
.WRBn 



.SYSTM 
.WRLn 



.SYSTM 
.WRSn 



.XMTW 



Starting core address. 



Byte pointer to core buffer. 



Byte pointer to core buffer. 



Message address. 



Message address. 



Device code of keyboard 
transmitting the wait char- 
acter or -1 if wait request 
terminated. 



Starting relative block 
number. 



j bits 0-7: number of disk 
blocks, 
bits 8-18: channel number 
(if n = 77). 



i Write byte count, including 
| terminator, returned at end 
I of write. 



Channel number (if n = 77). 



Number of bytes to be 
written. 



Message (non-zero). 



Message (non-zero). 



right byte: channel number 
(if n = 77). 

left byte: # of MCA retries 
(each retry takes 
200 milliseconds). 
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ERROR MRWAHF SUMMARY 















Code 


Mnemonic 


Meaning 


Applicable Commands 





ERFNO 


Illegal channel 


.APPEND 


.CLOSE 


.OPEN 






number. 


. MTOPD 


. MTDIO 


.RDB 








.RDL 


.RDR 


.RDS 








.WRB 


.WRL 


.WRS 


1 


ERFNM 


Illegal file 
name. 


.OPEN 


. MTOPD 


• INIT 


2 


ERICM 


Illegal system 
command. 


.RLSE 


.INIT 


.DELA\ 


3 


ERICD 


Illegal command 


.RDS 


• WRS 


.RDL 






for device. 


.WRL 
. MTDIO 


.RDB 
.GMCA 


.WRB 


6 


EREOF 


End of file. 


.RDB 


.RDL 




12 


ERDLE 


Attempt to refer 
to a non-existent 
file or device. 


.OPEN 


.MTOPD 




15 


ERFOP 


Attempt to refer- 


.RDS 


.WRL 


.RDL 






ence an unopened 


.WRS 


. CLOSE 


. MTDIO 






file or device. 


.RDB 


.WRB 




21 


ERUFT 


Attempt to use a 
channel which is 
already in use. 


• APPEND 
. MTOPD 


• GCHN 


. OPEN 


22 


ERLLI 


Line limit exceeded. 


.RDL 


.WRL 




23 


ERRTN 


Attempt to return 
(. RTN/. ERTN) from 
current program. 


.RTN 


.ERTN 




24 


ERPAR 


Parity on read line. 


.RDL 






26 


ERMEM 


Not enough memory 
available. 


• MEMI 


.RDL 


.RDS 


27 


ERSPC 


Out of disk space. 


. wRB 






30 


ERFIL 


File read error. 


.RDS 




. MTDIO 


31 


ERSEL 


Unit improperly 
selected. 


.INIT 


• OPEN 


. MTOPD 
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Code Mnemonic 



Meaning 



Applicable Commands 



36 


ERDNM 


Device not in sys- 
tem, or illegal 
device code. 


.INIT 
.IDEF 


.RLSE 
.GMCA 


.IRMV 
.STMAP 


41 


ERTIM 


Attempt to set 
illegal time or 
date. 


.STOD 


.SDAY 




42 


ERNOT 


Out of TCBs 


.TASK 






43 


ERXMT 


Message address 
already in use. 


.KMT 


.XMT 


.XMTW 


45 


ERIBS 


Device code already 
in system. 


.DUCLK 


.IDEF 


.INIT 


47 


ERSIM 


Simultaneous read or 
write attempt on 
same QTY line. 


.RDL 
.WRS 


.RDS 
.WCHAR 


.WRL 


60 


ERFIU 


Attempt to open a 
busy MCA unit. 


.OPEN 






61 


ERTID 


Task I. D. error. 


.TASK 
.TIDS 


.TIDK 
.TIDP 


.TIDR 
. ABORT 


101 


ERDTO 


Device timeout 


.WRS 






103 


ERMCA 


No complementary 
MCA request. 


.RDS 




.WRS 


104 


ERSRR 


Short MCA receive 
request. 


.RDS 


.WRL 


.WRS 


106 


ERCLO 


Channel closed by 
another task. 


.RDL 
.WRS 


.RDS 


.WRL 


110 


ERABT 


Task not abortable. 


.ABORT 






113 


ERNMC 


No MCA receive 
request. 


.WRS 
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APPENDIX B 
GENERATING AND LOADING AN RTOS SYSTEM 

DEFINITION OF TERMS 

This appendix details the steps to be followed when creating an RTOS system tailored 
to a specific device/core configuration and to the channel /task environment of the real 
time program which will be supported by the system and user program, both in a disk 
and in a non -disk environment. 

System generation is the procedure followed to produce a relocatable binary which 
will trigger the loading of appropriate device drivers from the RTOS library, allo- 
cate tables and control blocks used by the system, and allocate a fixed number of 
channels and task control blocks. The system generation program, RTOSGEN, 
produces a relocatable binary with the default name RTOS. RB, by issuing a series 
of questions about the hardware configuration and the task/channel requirements of 
the user program. 

System loading is the procedure followed to load the system generation relocatable 
binary, user drivers if any, user relocatable binaries, and the RTOS library. 
System loading is accomplished by using a relocatable loader. 

PREPARATION FOR SYSTEM GENERATION 



If the system is configured with either a type 4048 or type 4057 moving head disk 
pack drive, it is necessary to format the disk pack using the appropriate formatter 
program before system generation is attempted. In general, all disk packs that 
are to be used in the system must be formatted prior to their use. Note that it is 
not necessary to format the disk cartridges used in a type 4047 disk drive. The 
disk pack formatter programs are stand-alone programs. The appropriate formatter 
programs and their associated manuals are listed below: 

Disk Pack Drive Formatter Program Manual 

Type 4048 095-000072 096-000039 

Type 4057 095-000071 096-000038 

SYSTEM GENERATION 

The following page contains lists of tapes required to generate and load a system in 
stand-alone and RDOS environments. To generate an RTOS program under the 
Stand-alone Operating System (SOS), the RTOSGEN program itself must be con- 
figured with appropriate device support before it can be used. Consult the Stand - 
alone Operating System User's Manual, 093-000062, for the procedures to be 
followed to configure and load SOS programs. 

B-l 



Stand -Alone Systems: 



KTOS TASK MONITOR LIBRARY 
RTOSI. LB 

RTOS HANDLER LIBRARY 
RTOS2. LB 

RTOS CASSETTE HANDLER LIBRARY 
(CASDR.LB) 

RTOS MAGNETIC TAPE HANDLER 
LIBRARY (MTADR. LB) 

RTOS FIXED HEAD DISK HANDLER 
LIBRARY (DSKDR. LB) 

RTOS MOVING HEAD DISK HANDLER 
LIBRARY (DKPDR. LB) 

Stand-alone Extended Relocatable Loader, 

or 

SOS Relocatable Loader 

RTOS SYSTEM GENERATION PROGRAM 
RTOSGEN 

RTOSGEN. RB (to produce RTOSGEN 
under SOS) 

GSU13R.RB (to produce RTOSGEN 
under SOS) 

RDOS Systems : 

RDOS/MRDOS DUMP: RTOS SYSGEN PROGRAM 
RTOSGEN. SV 

RDOS/MRDOS DUMP: RELOCATABLE LOADER 
RLDR.SV 

RTOS TASK MONITOR LIBRARY 
RTOSI. LB 

RTOS HANDLER LIBRARY 
RTOS2. LB 

RTOS CASSETTE HANDLER LIBRARY 
(CASDR. LB) 

RTOS MAGNETIC TAPE HANDLER 
LIBRARY (MTADR. LB) 

RTOS FIXED HEAD DISK HANDLER 
LIBRARY (DSKDR. LB) 

RTOS MOVING HEAD DISK HANDLER 
LIBRARY (DKPDR. LB) 



99-0000f>0 

099-0000ol 

• 099-000062 

099-000063 

()99-()( 10064 

099-000065 

091-000038 
089-000120 
091-000081 

089-000163 
089-000164 

088-000082 
088-000049 
099-000060 
099-000061 
099-000062 
099-000063 
099-000064 
099-000065 



List of Tapes for System Generation and System Loading 
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Loading RTOSGEN in a SOS or Stand-alone Environment 

RTOSGEN is provided as a stand -alone program on paper tape for users wishing 
to perform RTOS system generations without the support of RDOS. Standard 
binary load procedures, described in section 2. 8 of How to Use the Nova 
Computers, must be followed to load either the stand-alone RTOSGEN program 
or RTOSGEN run under SOS. 

Loading RTOSGEN in an RDOS Environment 

RTOSGEN 1S r>T\wir1p»rl 3<3 a saup fil<=> nn nmnor t-ar»o fr\-v hoo-i-ct Tir-i.-.l-iiii™ «-^ v^-~*„-„, — „ 

system generation on an RDOS system. To load this save file, mount tape number 
088-000082 in the reader, and type the following command to the CLI: 

The system will respond: 

LOAD {$ctr}' STRKE ANY key - 

Load the reader with the dump tape and strike any console key. The tape will be 
read, and the teletype will respond: 

RTOSGEN. SV 
Producing the RTOS Module 

You are now ready to begin executing RTOSGEN. This program configures the 
system by interrogating you as to the hardware characteristics and channel/task 
requirements of your program. If RTOSGEN is loaded using binary load procedures, 
it will self -start. In an RDOS system, type the command 

RTOSGEN ) 
to invoke the program. 
The system generation program now outputs the message: 

RTOS SYSTEM GENERATION 

and proceeds to issue a series of questions requiring operator keyboard responses. 
An improper reply to an RTOSGEN question causes the question to be repeated. 
The questions are given and responded to in the following order unless stated 
otherwise. 
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Producing the RTOS Module (Continued) 

1. CORE STORAGE (IN K WORDS) 

Respond with any number from 4 (4K) to 32 (32K) in increments of 2 (2K), and 
follow this and all other responses with a carriage return. 

2. RTC FREQ (0=NONE, 1=10HZ, 2=100HZ, 3=1000HZ, 4=LINE) 

Respond with 0, 1,2, 3, or 4 as appropriate. If you give a non-zero response, 
the system will maintain the system clock and calendar. You are cautioned to 
select the lowest acceptable frequency, since higher clock frequencies increase 
system overhead. If the line frequency is requested, RTOS asks question 3; 
otherwise, it steps to question 4. 

3. LINE FREQ (0=50HZ, 1=60HZ) 

Select or 1 as appropriate. RTOSGEN now goes to question 4. 

4. TASKS (1-255) ? | 

Respond with a decimal integer from 1 through 255 corresponding to the number 
of tasks required by your program which will be loaded with the RTOS module. 
If you select one task, the minimum task scheduler, TMIN, will be loaded from 
the RTOS library; otherwise the multitask scheduler, TCBMON, will be loaded. 

5. CHANNELS (1-63) ? 

Respond with a decimal integer from 1 through 63, corresponding to the number 
of simultaneously open channels required by your program. 

After you have answered questions 1 through 5, RTOSGEN responds: 

RESPOND WITH NUMBER OF UNITS 

RTOSGEN now continues with a series of questions concerning peripheral 
support given to your program. 

6. DSK (0-1) ? (fixed head disks) 

If you respond "0", the program steps to the next question; a response of "1" 
prompts the following series of questions : 

DISK STORAGE (IN K WORDS) 

Respond with any decimal integer from 128 (K equals 1024io) through 2048 
(2 million words) in increments of 128 (128K). The program then queries you 
about the file subdivisions and file names you may wish to assign to the disk 
space for the fixed head disk. These queries are made in a series of questions 
with three parts each: 
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Producing the RTOS Module (Continued) 

1ST BLOCK? 
END BLOCK? 

NAME? 

You respond with the first logical block address in each disk file; the first avail- 
able block will be unless you plan to use the disk bootstrap program, HIPBOOT, 
to load and execute RTOS programs. If disk space for HIPBOOT is to be reserved, 
the first available block address is block number 6. 

Vrtii mnpt ncoi/w o f-i l^i nor-no t-n oil HioV onQ^o ™rhi^l"l T7TM1 want trt Vl*3 nrnOTflm 

accessible. The file names you define will be the names by which the disk 
files are opened via the system . OPEN command. File names consist of 
from 4 to 6 upper- case alphabetic and numeric characters. Each file name 
must uniquely identify its associated file; the same block cannot be assigned 
more than one file name, since one disk block cannot be included within the 
file space of more than one file. Files defined during system generation 
cannot be expanded or reduced in size. For a discussion of contiguous disk 
files, see Chapter l,"Disk File Organization." 

After defining all file space, respond with a carriage return to the "1ST 
BLOCK" question. RTOSGEN will now proceed to question number 7. 

7. DKP (0-4) ? (moving head disks) 

Respond with the number of moving head disk units in your system (the 404 7B 
is considered to be two units). If there are no moving head units, respond 0; 
the system will then proceed to question 8. 

After you answer the unit number question affirmatively, the program requests 
the number of sectors per surface in each unit, "and the number of disk sur- 
faces per unit ( see How to Use the Nova Computers for a discussion of disk 
terms): 

#SECTORS ? 

# SURFACES/UNIT ? 

Specify 6 sectors for the 4048 unit, or 12 sectors for either the 4047 or the 
4057 units. Specify 2 surfaces for the 4047 unit, 10 for the 4048 unit, or 20 
for the 4057 unit. 

The program then queries you about the file subdivisions and file names you 
wish to assign to the disk space for each moving head disk unit. These queries 
are made in a series of questions with three parts each: 
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Producing the RTOS Module (Continued) 

1ST BLOCK? 
END BLOCK? 
NAME? 

You respond with the first logical block address in each disk file; the first 
available block in each unit will be unless you plan to load the disk boot- 
strap program, HIPBOOT, for use in loading and executing RTOS programs. 
If disk space for HIPBOOT is to be reserved, the first available block address 
is block number 6. 

You must assign a file name to all disk space which you want to be program 
accessible. The file names you define will be the names by which the disk 
files are opened via the system . OPEN command. File names consist of 
from 4 to 6 upper-case alphabetic and numeric characters. Each file name 
must uniquely identify its associated file; the same block cannot be assigned 
more than one file name, since a single disk block cannot be included within 
the file space of more than one file. Files defined during system generation 
cannot be expanded or reduced in size. For a discussion of contiguous disk 
files, see Chapter 1,'TJisk File Organization." 

After defining all file space within each moving head unit, respond with a 
carriage return to the "1ST BLOCK" question. RTOSGEN will now proceed 
to question number 8. 

8. MTA (0-8) ? (magnetic tape transports) 

Respond with the appropriate integer indicating the number of 7- or 9-track 
magnetic tape transports in your system. 

9. CAS (0-8) ? (cassette units ) 

Respond with the appropriate integer indicating the number of cassettes in 
your system. 

10. PTR (0-2) ? (high-speed paper tape readers) 

Respond with the appropriate integer indicating the number of high-speed 
paper tape readers in your system. 

11. PTP (0-2) ? (high-speed paper tape punches) 

Respond with the appropriate integer indicating the number of high-speed 
paper tape punches in your system. 
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Producing the RTOS Module (Continued) 

12. LPT (0-2) ? (line printers) 

Respond with the appropriate integer indicating the number of line printers 
in your system. If your response is 1 or 2, the program asks you for the 
column size(s) of your printer(s) with the query: 

COLUMN SIZE (80, 132) 

The query is repeated if you have specified 2 line printers in your system. 

13. CDR (0-2) ? (punched or mark sense card readers) 

Respond with the appropriate integer indicating the number of card readers in 
your system. 

14. PLT(0-2) ? (incremental plotters) 

Respond with the appropriate integer indicating the number of digital plotters 
in your system. 

15. QTY (0-64) ? (asynchronous data communications multiplexor lines) 

Respond with the appropriate integer indicating the number of full duplex 
lines in your system. 

16. TTYS (0-3) ? (teletypewriters or video displays) 

Respond with the appropriate integer indicating the number of teletypewriters 
or video display units in your system. 

17. MCA (0-15) ? 

Respond with the appropriate integer indicating the number of MCA lines in 
your system (each line is capable of both transmitting and receiving). If your 
response is non-zero, the program asks you for the default number of trans- 
mission retries: 

#TIMEOUT RETRIES (0-65535) ? 

Each hardware timeout consumes approximately 10 milliseconds. After you 
respond to this question, the program outputs a query signaling the approach 
of the last block of RTOSGEN questions: 

RESPOND WITH FOR NO, 1 FOR YES 
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Producing the RTOS Module (Continued) 

18. AUTO RESTART? 

Respond "1" if the power fail/auto restart is included in your system; other- 
wise, respond to "0". 

19. HIGH PRIORITY INTERRUPTS? 

Respond "1" if you have any user-written drivers whose interrupts you want 
to be serviced before all system devices (but after the power fail monitor 
and real time clock). Respond "0" if you do not have any high priority interrupt 
devices. If you respond "1", the program will ask you for the name and device 
code of each high priority interrupt device (the name consists of 3 alpha- 
numeric characters): 

DEVICE CODE? 
NAME? 

The system appends "IS" to the device name and inserts the name into the high 
priority interrupt table. After listing all high priority interrupt devices, 
respond with a carriage return to the DEVICE CODE query, and the program 
will then step to question 20. 

20. USER SUPPLIED DRIVERS? 

Respond "1" if you have any user-written drivers you want included in the 
RTOS module output by RTOSGEN. (This is an alternative to introducing 
drivers at run time by the system call . IDEF . ) If you have no such drivers, 
respond "0". If you respond in the affirmative, the program requests the 
device code and name of each device (the name consists of 3 alphanumeric 
characters): 

DEVICE CODE? 
NAME? 

The system appends "DC" to the device name to create the DCT name for the 
device. After listing all user device drivers, respond with a carriage return 
to the DEVICE CODE query, and the program will then step to the RTOS 
system generation summary. 

Having responded to the above questions, RTOS outputs a list of all device 
codes, DCT names, and device names for all system devices and user devices 
specified during the system generation process. The power fail/auto restart 
option and high priority user interrupt devices are not included in this list, 
since there is no DCT associated with these devices. 
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Producing the RTOS Module (Continued) 

After the list has been finished, the program asks whether the system gener- 
ation procedure has been followed satisfactorily: 

SYSGEN OKAY? 

At this point you must decide whether or not there are any errors in your 
selections of devices; if there are no errors, type "1"; otherwise type "0". 
If you type "0" the entire system generation dialogue will be repeated. 

21. If you respond "1", RTOSGEN will then ask the name of the file or device 
which is to be used for outputting the RTOS module: 

OUTPUT FILENAME? 

Respond with the name of the appropriate file or device. Respond with a 
carriage return if the default name RTOS. RB is desired. 

After the RTOS module has been output under RDOS, the system will output an R 
prompt and return to the CLI. RTOSGEN will restart itself in a stand-alone 
program. 
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Producing the RTOS Module (Continued) 



The following information is given as a guide for estimating the size in words of any 
tailored RTOS system. Sizes are given in decimal and exclude page zero require- 
ments : 

(1) 



Basic System : 
Options : 



.(2) 



Multitask Programming 
Each additional TCB 
Each additional channel 
Power Fail/Auto Restart (PWRDR) 
High Priority Interrupts (n = number of high priority 
devices excluding RTC and PWR) 
Real Time Clock (RTCDR) 



1393 



662 

12 

2 

103 

11 + 3n 



296 



Peripherals : 



Fixed Head Disk (DSKDR) 
Moving Head Disk (DKPDR) 
Each disk file 

Magnetic Tape Controller (MTADR) 

Cassette Controller (CASDR) 

Tape service routine (MTSER); can be shared by 

Ml'A and CAS 
Teletype Driver (TTYDR) 

Each additional Teletype (TTY1D, TTY2D) 
Paper Tape Reader (PTRDR) 

Second Paper Tape Reader (PTR1D)) 
Paper Tape Punch (PTPDR) 

Second Paper Tape Punch (PTP1D) 
Card Reader (CDRDR) 

Second Card Reader (CDR1D) 
Line Printer (LPTDR) 

Second Line Printer (LPT1D) 
Plotter (PLTDR) 

Second Plotter (PLT1D) 
Device Name Table, . CHTB 

Type 4060 Multiplexor (QTYDR) 

Each QTY line 
Multiprocessor Communications Adapter (MCADR) 

MCA Device File Table (. MCTB) 



147 
309 

5 for fixed head, 

6 for moving head 
49 

49 

444 
233 

65 
141 

37 

44 

24 
289 
120 

44 

24 

43 

24 
4* no. of single 
file devices 
502 

10 
495 

20* (no. of lines 
+ D 



(1) TMIN, SYSTE, INTO, RUN, GENIO, IOSER 

(2) TCBMON (less the size of TMIN), TXMT, TACAL, TSKID, TUMOD, TABOR 
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HTOS SYS TEE GENE! - ATI ON 

COTE STORAGE (IN K VORDS) 12 

r.TC FREE C K=NOME, 1= 1 FHE.. 2 = 1 EPFf. , 3 = 1 !?£>-/--• , .-.-i i . - ■. 
LIME rr.Ef C0=5SKS, 1 = 6£HE) 1 

tasks c 1-255) ? 10 

CHANNELSC l-e3) '? S 
RESPOND- VI TH NUEKE-EI Of UiJIT? 

DSKC0-1) ? 1 

DISK STORAGE (i:j K VOTES) 126 

DISK FILE STRUCTURE 
1ST BLOCK? 5 

TTM T'> T")T fl ("■-.' -5 ^ <~ --. 

NAME? FILEA 
1ST BLOCK? £■? 1 
END ELOCK? 5Cf 
NAME? FILER 
1ST ELOCK? 50 7 
Ei-JD ELOCK? 509 
HAKE? FILFC 
1ST BLOCiC? 5 IE 
END BLOCK? 511 
NAME? FILED 
DKPC0-4) ? 
NTAC0-8) ? 
CASK 0-8) ? S 
PTEC0-2) ? 1 
PTPC0-2) ? 1 
LPT C 0-2) ? 1 

C0LUK.M SITE CSC, 132) 30 
CDFCE-2) ? 2 

PLTce-2) ? g 
b:TY<e-e4) ? e 

TTYSC0-3) ? 1 
HCAC(?-15) ? 2 

# TIMEOUT RETRIES (E-65535) ? SC- 
REE FOND V.ITH FOR .JO.. I FUF YE5 
AUTO RESTART ? 1 
HIGH PRIORITY INTERRUPTS? 0. 
USER SUPPLIED DRIVERS? 
SUMMARY OF P. TO S 3YSCEN 
CODE DCT MAKE NAME 



Cc 


KCTDC 




07 


NCRDC 




12 


TTIDC 


STTI 


I I 


TTOL'C 


STTO 


12 


PTRDC 


SPTF: 


13 


PTPEC 


SPTP 


14 


RTCDC 




1? 


LFTDC 


SLPT 


20 


DSKEC 





SYSGEN OKAY? 1 

OUTPUT FILENAME ? SYS1 



Sample RTOSGEN Dialogue 
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LOADING AND RUNNING A PROGRAM IN A STAND-ALONE ENVIRONMENT 

Having produced the RTOS module, you are now ready to load the operating 
system witii program relocatable binaries and execute it as an RTOS program 
or run it under RDOS. If you wish to load and execute it in a stand-alone environ- 
ment you must first perform a stand-alone or SOS relocatable load. 

Performing a Stand -alone or SOS Relocatable Load 



For a complete description of operating procedures using the SOS and stand- 
alone extended relocatable loaders, refer to the Extended Relocatable Loaders 
Manual , 093-000080. The following summarizes stand-alone procedures 
required for loading system and user programs. 

The stand-alone relocatable loader is in absolute binary format, and thus it 
is loaded by means of the binary loader. Once loaded, the relocatable loader 
self-starts and types on die console: 

SAFE= 

You respond with a carriage return to reserve the upper 200 words of memory, 
preserving both the bootstrap and binary loaders. The relocatable loader now 
outputs the prompt: 



You now proceed to load a series of paper tapes, following tape loading pro- 
cedures which will be described. The order in which the first three categories 
of tapes is loaded is not critical; the RTOS libraries must be the last items 
loaded: 

1. The RTOS module 

2. User drivers (if any) 

3. User relocatable binaries (the user program proper) 

4. The RTOS libraries 

To load each of the above paper tapes, mount each tape in turn in either the 
teletype reader or the paper tape reader, and type either 1 or 2 indicating to 
the loader whether the teletype reader (1) or the high-speed reader (2) is to 
be used. After loading each tape, the loader outputs the star prompt (*). 
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Performing a Stand-alone or SOS Relocatable Load (Continued) 

After the last paper tape has been loaded, you may request a loader map by typing 
the number 6, Then, to terminate the load process and "re^arc the program for 
execution, type the number 8. This causes the previously loaded program to be 
moved so that it resides at the absolute addresses indicated by the loader map. 
After shuffling the program downward to its indicated positions in core memory, 
the loader halts. 

If the SOS Magnetic Tape/Cassette relocatable loader (SOS loader) is to be used, 
the core image loader/writer should first be loaded into main memory; the same 
series of files must then be loaded in sequence. After the prompt 

RLDR 

is received, a command line must be input via the console. Suppose that cassette 
files are used and three cassette transports are available. Moreover, the user 
RTOS program binaries exist on file zero of one cassette, and the RTOSGEN 
module, user drivers, and RTOS libraries exist on files 0, 1, and 2 of another 
cassette. One possible command line would be as follows: 

$TTO/L CT0:1/S CT1:0 CT1:1 CT2:0 CT1:2 } 

This command line would cause a numeric symbol table listing to be output on 
$TTO and the RTOS save file to go to file 1 of transport (CBOOT, the cassette 
bootstrap, exists on file 0). The RTOS module, user drivers user program 
binaries, and RTOS libraries are then loaded in order. Upon the successful com- 
pletion of the relocatable load, the message 'OK" is output on the console and the 
system halts with the loaded program in core memory ready to be executed. 

Executing a Stand-alone Program 

The first operation performed by any program run under RTOS is a system initial- 
ization. Since the address of the RTOS initialization routine always resides in 
location 2, control must be dispatched to the address in location 2 in order to start 
an RTOS program. RTOS has a JMP @2 instruction at location 376. Thus to 
start your program, place "376" in the data switches, press RESET, then START. 

RTOS will initialize the system and transfer control to your program if you defined 
a starting address in your program in the . END statement. If you defined no such 
starting address, you must now place your program starting address in the data 
switches and press START. Your program now runs until a HALT or JMP. instruc- 
tion is encountered, or all tasks are killed (in which case control is returned to the 
task scheduler). 
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LOADING AND RUNNING A PROGRAM IN AN RDOS ENVIRONMENT 

After writing your program, you may test it as an RDOS save file, you may run it 
on an RDOS system as a stand-alone program (disabling RDOS temporarily), or you 
may output it as an absolute program on some external medium for execution on 
another system. 

Running the program under RDOS for test purposes may save you debugging time. 
This procedure is equivalent to testing and running an RDOS save file, since the 
RTOS command set is a compatible subset of the RDOS command repertoire. If 
you wish to test your program under RDOS, consult the Extended Relocatable 
Loaders Manual , 93-000080, and the Real Time Disk Operating System User's 
Manual , 93-000075. Note that you may specify task/channel information either via 
RLDR local switches /C and /K, or in the . COMM TASK statement. 

Alternatively, you want to load your RTOS program using the RDOS loader but with 
the RTOSGEN module and RTOS libraries, and execute your program on this RDOS 
system or on another RDOS system. The following sections describe these pro- 
cedures. 

Loading an RTOS Program under RDOS 

For a complete description of operating procedures using the RDOS relocatable 
loader, refer to the Extended Relocatable Loaders Manual , 93-000080, and to the 
Real Time Disk Operating System User's Manual , 93-000075. The following 
summary information gives procedures for loading a user program with the RTOS 
module under RDOS. 

The following files are required for the relocatable loading process: 

1. RTOS.RB (produced during RTOS system generation). 

2 . User drivers, if any. 

3. User relocatable binaries (i.e., the user program proper). 

4. The RTOS libraries. 

These four files must be loaded onto disk by mounting each on the teletype reader 
or high-speed reader and by issuing the following command: 
( $PTR ) 

XFER |$TTr} MS£*2£) 

Having loaded all the necessary tapes, you now issue the CLI relocatable load 
command : 
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Loading an RTQS Program under RDOS (Continued) 
RLDR/Cf /Dj user binaries f user drivers j RTOSGEN module RTOS libraries f 
[$TTO/L) 



|$lpt/l( 



; 



This command will cause the complete save file to be constructed, starting at 
location zero. The load map will be output on the listing device, if one is specified. 

Tl 1T1 f*ho aKr^TrO i11nnfi*n«-i n *t ,,«-- 1 1___11,t it * , . 

-. ~. -^ ^v,,^, ^uo^auuu yuu imve ioauea uie aeougger (global /D), you must do 
one of two things to transfer control to the debugger. Your choice depends upon 
the means selected to start the RTOS program. These means are described 
fully in the following section. If location 2 will receive control upon the execution 
of the save file, then the debugger address (found in the load map, DEBUG) must 
be placed on location 2 via the Octal Editor. Alternatively, you may get the 
debugger address from location 406 of the program's User Status Table and start 
at that address. In either case, after starting the debugger, the command 
" .RTOS$R" will transfer control to the RTOS initializer, starting the RTOS pro- 
gram. 

Executing an RTOS Program with HIPBOOT 

Having performed a relocatable load of your program with the RTOS module and 
RTOS libraries, you may now choose from many different methods to execute the 
program; your choice of method will be made largely on the basis of the type of 
system which will be used to run the program. 

If you intend to execute the program on an RDOS system, you may use the disk 
bootstrap program, HIPBOOT, to transfer control to your program. Otherwise, 
you must produce an absolute binary paper tape, or a magnetic tape/cassette 
version of the program and load it on another system by means of an appropriate 
loader. If HIPBOOT is used, the computer halts at the termination of loading. 
This provides an opportunity to activate the debugger via the front panel 
switches, if desired. 



If your program is to be executed on the present RDOS system or on another RDOS 
system you may invoke the disk bootstrap program, HIPBOOT, to execute your 
program. If the RTOS program is on a removable pack or cartridge you may 
simply transfer the pack or cartridge to the new system; otherwise you must dump 
the RTOS save file and reload it on the new system: 
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Executing an RTOS Program with HIPBOOT (Continued) 

DUMP outputdevicename program -name. SV J 

LOAD inputdevicename program -name. SV J 

Having obtained a copy of the RTOS program on the RDOS system where it is to be 
run, you now invoke HIPBOOT, following ordinary disk bootstrap procedures. 
These procedures are described fully in the RDOS User's Manual , Appendix E; a 
summary of these procedures follows. 

Disk bootstrap procedures vary with the type of computer used and the presence or 
absence of the program load feature. The following three procedures are given. 

1. Nova 2/Nova 1200/Nova 800 series without the Program Load Option: 

a. Enter in location 376: 60 Inn 

where nn=20 when bootstrapping from the fixed head disk and 
nn=33 when bootstrapping from the moving head disk. 

b. Enter in location 377: 377. 

c. Press RESET, then start at location 376; go to step 3c. 

2. Nova 2/Nova 1200/Nova 800 series with the Program Load Option: 

a. Set bit of the data switches up. 

b. Enter the proper disk device code (20 or 33 as described in 
la. ) into the data switches, bits 10-15. 

c. Press RESET, then PROGRAM LOAD; go to step 3c. 

3. Supernova: 

a. Enter the proper disk device code (20 or 33 as described in la). 

b. Press RESET, then CHANNEL START. 

c. HIPBOOT now requests the name of your program. 

FILENAME? 
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Executing an RTOS Program with HIPBOOT (Continued) 
You must now respond with the name of your program in one of two ways: 
1. name / A ) 

J 



If you select the first method, your program will be loaded into memory and the 
computer will halt. You then place a starting address (your program's or the 

H^iH^^n•fr^lr■ , c\ intv-* t4io aHHrocc uwif-r'l-icic' tm-^oo RErCRT 1 nti^ *4-*^i-i CTADT rf imn 

"^""66^* ^ t J - A *«^-' WAS- UUUiVUJ UI«±lA-llUk)| |JX^OJ IklJUU i f UAXV-t U1UX1 UXAA.XVX. XX V KJ CI 

select the second response, the program will self-start. 

Having been loaded, if the RTOS program self-starts it will initialize the system 
and transfer control to your program if you defined a starting address via your 
program's . END statement. If the program does not self-start, you may start at 
either the contents of location 2 or, to activate the debugger, at the contents of 
location 406. 

Since this procedure overwrites portions of RDOS, RTOS gains control; RDOS can 
only be restored via disk bootstrap procedures similar to those given on the pre- 
vious page. 

Executing an RTOS Program with TBOOT, CBOOT or MCABOOT 

If you wish to execute your program on a system which has a magnetic tape 
transport or cassette unit, you must first transfer the magnetic tape bootstrap 
(TBOOT) or cassette bootstrap (CBOOT) to file of the tape on unit 0. 



INIT 



I TBOOT. SV) (MT0:0) 
XFER \ > ] > ) 

( CBOOT. SV* (CTO:0; 

After transferring the appropriate tape bootstrap to file 0, transfer the RTOS 
program to file 1 of the same tape: 

(MT0:n 
XFER program name. SV < / ) 

(cT0:l) 
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Executing an RTOS Program with TBOOT, CBOOT or MCABOOT (Continued) 

If several RTOS programs are to be stored on the tape reel, they can be trans- 
ferred to sequential file numbers following file 1. 

Having produced the tape reel, release the reel via the RDOS command 

fMTCn 



RELEASE < 

(CTO 



> 



Dismount the reel, and mount it on the unit zero transport or cassette unit of the 
system where the RTOS program(s) is to be executed. 

After mounting the reel, perform one of the following operation sequences: 

1. On machines having the Program Load feature (Nbva 2/800/1200 
families), set the console switches to 100022 for a magnetic tape 
transport, or 100034 for a cassette unit, and press PROGRAM 
LOAD. 

2. On Supernovas with the Channel Start option, set the console 
switches to octal 22 (for a magnetic tape unit) or octal 34 (for a 
cassette unit), and press RESET, then CHANNEL START. 

3. On machines without Channel Start or Program Load 
options, deposit NIOS MTA (60122) or NIOS CTA (60134) in 
location 376, deposit 377 in location 377, press RESET, and 
START at location 376. 

The appropriate tape bootstrap program will be loaded into memory, and the 
following initialization message will be output on the console: 

FULL (0) OR PARTIAL (1) ? 

Type "1" in response to this query, and the tape bootstrap will then request the 
number of the file containing the program which is to be executed: 

f MT0:1 

FROM < > 

(CTO:) 
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Executing an RTOS Program with TBOOT, CBOOT or MCAROOT (Continued) 

Respond with the number of the file containing the program, and follow this with 
a carriage return. The tape file will be read, and control will be given to your 
program. 

o.o transmit an RTOS program from one CPU to another via the multiprocessor 
communications adapter, two actions must be performed: one at the transmitting 
RDOS CPU, and another at a receiving CPU. At the transmitting CPU, the fol- 

lowino* f 1 T I ^Amv^^«ri *-*-.,. ,-.*. i — ^ j 

lUWXll^ ^.Ui ^wiiiiiicuiu 111USL JJC ItibLlfcJU. 

MCABOOT MCAT:n RTOS program name /S 

where n is a number from 1 to 15 decimal denoting the receiving MCA unit 
number. At the receiving CPU, an operator must have requested the sender's 
transmission by first placing "100007" in the receiver's data switches, then by 
depressing RESET, followed by PROGRAM LOAD . The transmitting unit 
will wait for the receiver to request the transmission, up to the default timeout 
period. After the RTOS program has been received, me receiving operator must 
place the value "376" in the data switches, and then press RESET followed bv 
START. y 

EXECUTING AN RTOS PROGRAM VIA PAPER TAP E WHICH WAS PRODUCED UNDER 
RDOS " " 

If you have loaded your RTOS program via the RDOS relocatable loader, but now 
wish to run this program in a stand-alone environment, you may output this program 
onto paper tape. If you do not wish to preserve a disk file containing this RTOS 
program, simply issue the command: 

($TTP) 
MKABS/Z program name. SV f 376/S} < > ) 

($PTP) 

Alternatively, if you wish to preserve a disk copy of this program before outputting 
it onto paper tape, issue the commands: 

MKABS/Z program name. SV program name . AB f 376/S] ) 
XFER program name .AB $PTP ) 

The paper tape version of your program can now be loaded onto a non -RDOS 
system following conventional binary load procedures. After loading the paper 
tape, if you supplied the intializer entry with the /S switch, control will be 
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EXECUTING AN RTOS PROGRAM VIA PAPER TAPE WHICH WAS PRODUCED UNDER 
RDOS (Continued) 

transferred to the RTOS initializer; if you did not specify an initializer entry 
address, you must place the value "376" into the data switches, press RESET, 
then START. 

In either case, after RTOS performs its initialization it will transfer control to 
the starting address of your program if you specified a starting address as an 
argument in the main program's . END statement. If you specified no such 
starting address, the machine will stop after initialization and you must place 
your program's starting address in the data switches, press RESET, then START. 
Your program will now run until a HALT or JMP . instruction is encountered. 



EXECUTING AN RTOS PROGRAM WITH THE SOS CORE IMAGE LOADER/WRITER 

If the SOS core image loader/writer is to be used to execute an RTOS program, 
one of two relocatable loaders must have been used and one of two corresponding 
means must have been used to place the RTOS program onto cassette or magnetic 
tape: 

1 . SOS relocatable loader (the core image loader/writer must have 
been resident in main memory before the relocatable load). 

2. RDOS relocatable loader. 

If the first method is selected, the core resident RTOS program must be written 
onto either a reel of magnetic tape or a cassette cartridge onto which the loader/ 
writer has been written as file zero. Core image loader/writer operation is 
discussed in detail in the SOS User's Manual , 093-000062. In summary, to 
transfer the SOS relocatably loaded program to tape, start the computer at the 
next to last address in main memory. This will activate the loader/writer, which 
outputs a prompt, "#". After outputting the prompt, the loader /writer waits for 
you to input a device number and file number, separated by a colon, to which the 
core resident program is to be written. After the file has been specified, the 
core image writer will request specification of the upper core address (NMAX) 
to be written onto tape. It does this by typing 

NMAX: 

on the console. You must then respond with the highest core address (in octal) 
which is to be written out. 
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EXECUTING AN RTOS PROGRAM WITH THE SOS CORE IMAGE LOADER/WRITER 

(Continued) 

Having written the RTOS program onto tape, it then may be read in from tape and 
be executed by means of the core image loader. Set the console data switch up, 
and activate the core image loader by starting the computer at the highest available 
memory address. The loader issues the "#" prompt on the console, and then awaits 
your response of a device number (0-7),colon, and a file number (0-99) followed by 
a carriage return. The indicated tape file is then loaded into memory starting at 
address zero. The loader will halt after loading is complete. 

If instead of the SOS loader the RDOS relocatable loader is used to create the RTOS 
program, this save file can be XFERed by the CLI to a file on cassette or magnetic 
tape. This file can then be executed by means of the core image loader as des- 
cribed above. 

The illustration on the following page summarizes the various methods which may 
be used to execute an RTOS program. The illustration starts with the relocatable 
binary modules comprising the program; these binaries are produced either by an 
RDOS assembler or by the SOS assembler. 
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APPENDIX C 



RTOS PARAMETERS 



oupplicu wilil rv iuo io a ocl ui poiaiucicia vviij.»~ii iiiuoi uc ctoociiiuxcia wiui pj.<jgj.aiiis 

using RTOS and using system -defined mnemonics. A listing of these parameters 
begins on page C-2. 
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UPRla 


TPRST 


; .uusr 


QRNa 


6 


; ,ousr 


QT1.NKB 


Tln* 


; .DuSR 


UOCMs 


10 


; .dusk 


UCONUa 


11 


J.DUSR 


OTLNi 


QCOnD 
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ikXiVt .MAIN 

w l 

02 

BO 

04 

03 

06 

08 

«5y 

lid 
11 
12 

13 

14 
15 
10 
1/ 
1« 
1* 

2 id 
21 
22 



BldtfidbO" 
000003 
00«J0tf7 
Id0id017 
lc0kJ0 1 7 
00K017 
ididwSi 7 
000217 
H00617 
KJ0W7 1 7 
UOH17 

v ~ * * * r 

0017.37 
KI01777 
001777 
0017/7 



I DEFINfc rHt uEvlCE MASK bITS 
; RUOS REv 3 VERSION 



i \a ft i, 



.OUSR 
.UUSR 
.UllSR 
.UUSR 
,lHJS» 
.UUSR 
. UUSR 
.OUSR 
.UU!>R 
.ullt>« 

iillGD 
• V V \1 " 

.UUSR 
.OUSR 
,0U3» 

.UUSR 



MKTTI« 
MKQTYe 
MkPTP" 
MKMCAb 
MnPlTb 
MKLPTs 
MKDPO« 
MNDPIs 
MivDKPb 
MK()SK« 

U - T D [3 - 

nr\ x r ci - 

MKPIRs 

MKCLiRs 
MkMTAs 

MKCASs 





; TTU 


MKTTO 


? t r i 


MKTTI 


; OTY 


Ibl3+MKTT1 


1 PTP 


lblii + MKPTP 


f MCA 


MKMCA 


J PIT 


MKPLT 


J LPT 


lt(0b*MKMCA 


; DPO 


MKDPO 


; op i 


lb07 + MKljPU 


t MMD 


18I09*MKUKP 


; fmd 


IbKo+MKuSK 


.' IPH 


lbll+WKiPb 


; pth 


IBlns + MKPTK 


; cuk 


*KCUR 


; mta 


MKMTA 


; cas 
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01 

02 
03 
04 
0b 
0b 
07 

00 

0* 
10 
11 
12 

13 

14 

15 
lb 
17 
lb 
19 
20 
21 
22 
23 
24 
2b 
2b 
2/ 
2b 
2t« 
30 
31 
32 
33 
3 4 
35 
3o 
37 
38 



.MAIM 



; OtFINt IHt EXCEPTIONAL bTATUS CUOES 



0000*0 


.UUSR 


EWFNOs 


P 


000001 


.OUSR 


fcHFNhi 


1 


c* 1? p id tf 2 


.UUSR 


F. R I C M b 


2 


000003 


.UUSR 


ERlCD* 


3 


000006 


.UUSR 


EREUFs 


6 


000012 


.UUSR 


EKOuEs 


12 


00001b 


.OUSR 


ERFUP* 


15 


000021 


.UUSR 


ERUFT* 


21 


000022 


.UUSR 


ERLLl* 


22 


000023 


.UUSR 


ERRTN« 


23 


000024 


• UUSR 


F.RPARs 


24 


00004b 


.UUSR 


ERMEMs 


2b 


000027 


.UUSR 


ERSPCs 


27 


000030 


• UUSR 


EhFIL« 


30 


000031 


.UUSR 


ERStL» 


31 


000036 


.UUSR 


EROk(M» 


3b 


000041 


.UUSR 


ERTIMs 


41 


000042 


.UUSR 


ERNUTs 


42 


000043 


.OUSR 


ERXMT» 


43 


00004b 


.UUSR 


ERIbS» 


4b 


000046 


.UUSR 


ERICB« 


46 


000047 


.UUSR 


EKSIM* 


47 




t .ous^ 


( ERUTS* 


50 


000060 


.UUSR 


EHFIU" 


60 


000001 


.OUSR 


ERTIUs 


61 


000U1 


.UUSR 


ERUTUs 


101 


000103 


.UUSR 


ERMCAs 


103 


000104 


.UUSR 


ERSKRs 


104 


000106 


.UUSR 


ERCLOs 


106 


000110 


.UUSR 


ERABTs 


110 


000113 


.UUSR 


EKNMC" 


113 



• fcOT 



; iLLtGAL CMANNtL Nu*»E* 

; ILLEGAL FiLt NAnE 

} ILLEGAL SYS1E* LO.ilANU 

f iLLtGAL CUMMANU F OR OEVlCc 

; end of file 

; A NUN-EXlbTtNT FIlE 

; FILc NOT UPfcNfcU 

; ATTEMPT TU uSt A uFT ALktAPY 1 c UaE 

; LINE LlMll EXCEEDtO 

>* .NTn/.EKTn W.ITH NuWhERE Tu b^ 

; PARITY ERROR uN RtAU LINE 

; NUT ENUP FiEMOkY AVAILABLE 

i out of file space 

; file read error 

; UnIT NOl PRUPtRLY StLtCTEu 

I ILLEGAL DtVICc NAME 

; USER SET TIME ERRoR 

; OUT OF TCO'b 

; SIGNAL ADUktSS ALREADY rttlSY 

; DEVICE ALREADY IN SYSTEM 

I INSUFFICIENT CONTIGUOUS SLOCKS 

I UTY ERROR 

; EHRUR IN USER TASK QUEUE TAbLfc 

1 FILt IN USF 

; TASK ID ERROR 

t DEVICE TIMEOUT 

; mca errur 

; shorter receive request 

; i/o terminatfu by close 

t TASK NOT ABORTAdLt 

; NO MCA RECEIVE REVUES! 



t END OF RTuS PARAMETER TAPE 
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APPENDIX D 

RTOS ASSEMBLY LANGUAGE AND FORTRAN IV PROGRAMMING 

This appendix illustrates a sample real time assembly language program and de- 
scribes the procedures which must be followed in order to load and execute a 
FORTRAN IV program under the Real Time Operating System. 

Assembly Language Illustration 

The sample assembly language program, illustrated on the following pages, causes 
four user tasks to compete for the use of the system console, $TTO. Each task 
types a unique message on channel zero. The sequence of events in the user 

program is as follows. 

First, all of the task calls which will be issued within the program are referenced 
externally by an . EXTN statement on line 6. Thus the following two task calls will 
be issued: . PRI and . TASK. If any task call were issued which was not externally 
referenced, the assembler would report an undefined symbol and the program would 
not be executable. System calls, on the other hand, must not be externally refer- 
enced; the SOS and RDOS assemblers recognize each system call mnemonic and 
assemble the appropriate value for each mnemonic. The . TXTM 1 statement, 
line 7, packs all text strings from left to right; this is always required under RTOS 
and RDOS. 

Upon entry to TOT, the start of the program and only entry point declared by the 
. ENT statement (line 5), the teletype is opened on channel zero. 
Next, the program creates three tasks and passes to each task a different displace- 
ment into the series of message byte pointers which will be used when the tasks 
output to the teletype. Note that each of the three tasks is created at priority 10g. 
When rescheduling occurs after each task call, the default task will continue to 
receive control since it is created at priority zero when the program is first 
started. After creating the three tasks, the default task adjusts its priority to that 
of the other three tasks so that it can compete for the teletype on an equal priority 
basis (line 30). 

Each of the four tasks now executes the code beginning on line 33, and outputs its 
message via system call . WRS . As each task issues the system call, it becomes 
suspended and control goes to the task scheduler, which raises the highest priority 
ready task to the executing state. Each task remains suspended until its system call 
is completed. If the error return from any system or task call is taken, the program 
issues a "JMP." call, and the task is idled. 

The program . END statement has the argument "TOT". This will enable the RTOS 
initializer to transfer control directly to the program. 
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U/«)l T i.j 

m 

A2 

Ai 

AS 
\A0 
1*7 
'A0 

fety 

1 id AVAtf.A 

11 rff'tfldl 

12 idPMtfi! 

13 tf tf to P 3 

14 *) (71 v< V 4 

10 A V. IT. H 3 

17 id Id Id V 

\ B to 1/ id \A 7 

\9 id C" >d 1 k> 

2tf id^idll 
21 

22 id t" a 12 

?J idPtflO 

2 4 ^ p id l 4 
2b 

26 KJClolb 

2? <iKi-.lt> 

26 rfdidl7 

29 

3H rfBlflgH 

31 0^21 

32 

33 idHid22 

31 id?n2J 

35 i,i?ifl?4 

36 en?<i23 

37 Idk?id26 

38 AVW7 

39 «!l id 3 1! 

4*5 (de*id3i 

41 

42 o(did32 

43 »t»i«33 

44 <U'tf34 
45 

45 .dPrfJb 
47 

4 9 tf tf vi >} b 
49 ididid37 

5 id 
31 
32 

53 id id id 4 2 

54 *s I/) td 4 j 
53 If) V A 4 4 
56 A id tf 4 o 
5 / I* ^ id 4 1> 
5tt Idfid4/ 



K4C«0 H t V U 2 



14:tff:32 -2/23/74 



id i* VI Id ill 



*l2ld4 Jh 

12b4kjid 
idtfoid 1 7 
M4i?i*ll< 
•did440 1 

^2/>425 
.424425 

l524Hf! 
177777 
<1 (fi 4 4 2 4 

15 1 4i/lV 
■A iA A V- 1 V. ' 
id i/ 4 4 2 1 

1 5 1 4 W f, 
*) id AV 1 3 ' 
,1ld4416 

177777 

1514*1 (* 

V>3442ld I 

1 5 7 H k? Id 
.d214*m 

'.1 2 4 4 ifi 7 
id S/> f> t- 1 7 

a 1 6 4 H p 
f.A 44ob 
^ v) Id 7 7 1 



IVHEUU'T TEST HITm Mln.TlTflSKlr.r- 

.TIVL TilT 

. L N T T T 

.tXTlM .HR1 .TASK 

.TXTM 1 

.NNfcl 



TUT; 



LOA iVi ,|lil 
SUB 1 1 
,SYST 

• OPtN Vt 
JSP EkR 

LOA ?■ PklUW 
LyA 1 NtwJASK 
SuB 2 2 
. TASK 
JSW EkH 

IM: 2 2 
.TASK 

JSH EkK 

INC 2 2 
. TASK 

J S W t h K 

• Pkl 
InC 2 2 



UUA 3 
AUO 2 



.MESS 
3 



LUA tf V 3 
Li'A 1 COUNT 
• SYST 
.*»$ io 
JSH EkP 
JMP L 



/widfilifi PklfjR: in 
*)ldldU22 'NtrtTAbK: 
ai/nddF count; 8, 



5* 
OA 



/i id «s 4 (tip fckft: 

viidkild76" ,T TU : 

/I22124 

«)62117 

Al*AV\AV 

' Jididld43' .flfcSSi 
1 idV.nl 1*" 

' A Id id 1 V " 

V, id id 142" 
1 tf id id 1 5 4 " 
' ob2U5 1 MtSsfi: 
^51513 

A 2 Id Id b 1 



JhP . 

. + 1*2 

,TX1 /$TTO/ 



. + 1 

MtSa^*2 

HtSSl*2 

*fcSS?*2 

*tSS3*2 

, TX T /TAS* 



1<15><12>/ 



Sample Assembly Language Program 
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rfde)2 tut 

HI 1306412 

V>i <W«554<*52itfl MtSSi: .TXT /TAS* 2<15><12>/ 

B4 «iS15U 

"S> -*2tf062 

06 idiH64 12 

U6 iiewei'tfSiiimi MtSb2: ,txt /task j<ib><i2>/ 

10 t2d«63 

11 JSi)6AlZ 

12 JttgRiap 

U Wfr)K)6o'/i521k)l MtSiJ: .TXT /TASK 4<15><12>/ 

14 *>S1513 

13 42UH64 

16 tf06412 

17 «J?to0t)ti 
Id 

19 .fcM/ TO 1 



Sample Assembly Language Program 
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* >i n 3 T o i 












Count 


V ii VS \6 3 4 




l/3b 


1/44 






trtfi 


W t-l i^! rf! J b 




1/14 


l/2tf 


1/24 


l/?e 


L 


fk'i» < )?2 




1/33 


l/4tf 


1/4.3 




Mtisei 


t*tf«!/i4/ 




1/54 


l/5tt 






Mtsai 


t"iltfrf54 




1/55 


2/U3 






MtSS2 


Htfflrf&l 




1/56 


2/GS 






MtSS3 


CiSiiitfbb 




1/57 


2/13 






Nt«! A 


nmm^jj 




1/17 


1/43 






PKluH 


tf»if*«)32 




l/lb 


t/42 






TUT 


0<WrfHi4 


fcn 


l/l«4 


1/05 


1/lM 


2/iy 


.mess 


KIBKM42 




1/33 


1/53 






,P*I 


F»Mtf2tf 


XN 


1/db 


l/3tf 






. TASK 


* [J ^ 1 b 


XN 


1/06 


t/19 


1/23 


1/27 


.ITU 


tfi<i«!!tf3b 




1/1* 


1/46 







1 /3* 



1 /«t 



Sample Assembly Language Program ( Continued) 
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The relocatable binary produced by assembling this program can be loaded by 
either the stand-alone extended relocatable loader, the SOS loader, or the RDOS 
loader. In this illustration we show the dialogue that ensues when the program is 
loaded by the stand-alone loader. 

---.i.^*. i-*i*^ iv^viV^tj. j.o a^«\_*w\^, XL uv^-n. OIU1LO anu UUIUULO L11C lliCOOCIl^e O-Tlir 1 li = • 

A carriage return response causes the top 200 locations to be saved, preserving 
the binary loader. After this, the star prompt is output. The program relocat- 
able binary (TOT), RTOSGEN module, and two RTOS libraries are then loaded. 

The RTOS module loader! with this nrna-ram Qr>p>i-Mfip>c ^ hoot- ^Qo^o T7,->iiv noni- 

tasks are needed, and a system task is also required since use of the peripheral 
device is simultaneously requested by more than one user task. At the termination 
of loading, (*8), the initializer starting address, 376, is placed in the data switches. 
RESET, is then pressed, followed by START. The program is initialized and begins 
at entry TOT, outputting the task messages until STOP is pressed. 



SAFE 


= 


*2 TOT 


*2 P.' 


ros 


*2 




*2 




*8TA! 


SK 1 


TASK 


2 


TASK 


3 


TASK- 


4 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


A 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


4 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


4 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


4 


TASK 


1 


TASK 


2 


TASK 


3 



Load Dialogue and Program Output 
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Real Time FORTRAN IV Programming 

Since RTOS is a compatible subset of RDOS, RTOS will support a subset of 
DGC Real Time FORTRAN IV. To write a Real Time (RT) FORTRAN IV program 
for use with RTOS, you may use either the RDOS FORTRAN IV compiler or the 
12K SOS FORTRAN IV compiler. Operating procedures for using these compilers 
are documented in the FORTRAN IV User's Manual , 093-000053, Appendix D. 
The only restriction on use of DGC RT FORTRAN IV under RTOS is that only those 
real time calls may be used which have corresponding system and task calls imple- 
mented in RTOS. Thus you must exclude use of the OVERLAY statement, and you 
may use all RT FORTRAN IV calls except the following: FCHAN, FOVLD, FOVRL, 
FSWAP, OVEXT, OVEXX, OVKIL, OVKIX, OVLOD, OVOPN, CFILW, DFILW, DIR, 
FSTAT, and WRITR. Only the following disk and tape I/O-related call are available: 
WRBLK and RDBLK for disk I/O, and MTOPD and MTDIO for magnetic tape. 

Having produced one or more FORTRAN IV relocatable binaries, you use relocatable 
load procedures which are similar to those documented in this manual, Appendix B, 
for assembly language program binaries. The only addition to these procedures 
is the loading of the FORTRAN run time libraries, RTOSFMT. LB, FORT1. LB, 
FORT2. LB, FORT3. LB and the appropriate integer multiply /divide library. Thus 
the relocatable load sequence using either the stand-alone extended relocatable 
loader, the SOS relocatable loader, or the RDOS relocatable loader is as follows: 

1. FORTRAN relocatable binaries (the program proper) 

2. RTOS module produced by RTOSGEN. 

3. RTOSFMT. LB (the RTOS real time FORTRAN IV run time library). 

4. FORT1. LB 

5. FORT2.LB 

6. FORT3. LB 

7. An integer multiply /divide library 

8. RTOS1.LB 

9. RTOS2.LB 

10. Other RTOS libraries as required (RTOS MTA. LB, RTOS CAS. LB, 
RTOS DSK. LB, or RTOS DKP. LB) 

After relocatable loading is complete, the FORTRAN program is started just as 
any other RTOS program is started. Details for executing an RTOS program are 
given in Appendix B. 
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APPENDIX E 

RTOS Source Level Incompatibilities 

Certain features of RTOS revision 3 operate differently from the way they did in 
die previous revision. A summary of these differences follows. 

1) An attempt to initialize or release a tape unit which has already been 
initialized will result in error ERD3S being reported, "device already 
initialized". Under revision 05, no error was reported, the normal 
return was taken, and the call performed no operation if the device was 
initialized. 

2) Under revision 05, system calls . RTN and . ERTN idled the system by 
executing a "JMP . " in locations USTRL/USTEL of the User Status 
Table. In revision 3 these displacements of the User Status Table have 
been removed; execution of either of these calls causes the error return 
to be taken unconditionally. 

3) The label of the entry point to the RTOS initialization routine has been 
changed from "INIT" to ".RTOS" . 



E-l 



INDEX 



.ABORT 3-lf, 6-5 

.AKILL 1-2, 3-lf 

.APPEND 2-2f, 2-6f 

.ARDY 1-2, 3-1, 3-3 

ASCII codes 2-14f 

assembly language illustration D-lff 

.ASUSP 1-2, 3-1, 3-3 

asynchronous data communications mux (see QTY) 



BEGIN fi-lf 



cassette tape 

data format 1 -6f 

initialization (see . INIT) 1-6 

I/O (see . MTOPD, . MTDIO) 
CBOOT 1-11, B-17f, B-22 
channel 1-4 (see .GCHN) 
characteristics inhibit mask 2-4f 
.CHTB 6-2, 6-10 

clock and calendar commands 2-26ff 
close a file or device (see .CLOSE, .RLSE, or 

.RESET) 
.CLOSE 2-2f, 2-7, 3-2 
.CMSK 6-2f 
.COMMTASK 1-10 
command summary A -Iff 
compatibility with RDOS l-9ff 
console interrupts (see .WCHAR) 
CSP 6-2f 
CTCB 6-2f 



.DELAY 1-2, 2-2, 2-26 

device control table (DCT) 4-lf, B-8, C-5 

device file tables (see . DTBL, . PTBL, .QTBL, 

. MCTB) 
device support under RTOS l-5f 
direct block I/O 2-3,2-10,2-16 
disk file structure l-8f, 2-1 
DISMISS 6-2f 
.DTBL 6-2, 6-6f 
.DUCLK 2-2, 2-29 



file and I/O system commands 2 -Iff 

formatting a disk B-l 

FORTRAN IV D-6 

free format I/O 2-3, 2-8f, 2-18ff 



.GCHAR 2-2, 2-22 
.GCHN 2-2, 2-6 
.GDAY 2-2, 2-27 
generating an RTOS system 
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.GMCA 2-2, 5-2f 
.GTOD 2-2, 2-28 



high priority interrupt devices 4-1, 4-5f, 6-81, B-8 

.HINT 6-2, 6-8f 

HIPBOOT 1-11, B-15f 

HMA 2-24f 

Hollerith - ASCII translation 2-14f 



.IDEF 2-lf, 4-2f, 4-5, B-8 

idle the system 1-2, 2-25 

.IDST 3-1, 3-3f 

incompatibilities, source level E-l 

.INIT 1-6, 2-2f, 2-8 

interrupt table (. ITBL) 4-1, 4-5f, 6-2, 6-9 

I/O modes (see direct block, line, sequential, 

free format) 
.INTP 6-1 
IOEND 6-2f 
.IRMV 2-lf, 4-3f 
.KMT 2-29, 3-1, 3-4f, 4-2, 4-6 



KILL 3-1, 3-5 



line I/O 2-3 

loading an RTOS program B-12ff, D-5 



error message summary A-7f 
.ERTN 2-2, 2-6 



magnetic tape- 
data format 1-7, 1-9 
initializing (see .INIT) 1-6 
I/O (see .MTOPD, .MTDIO) 

MCABOOT B-19 

. MCTB 6-6 

.MEM 2-2, 2-24 

.MEMI 2-2, 2-24f 
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memory size commands 2-23ff 

.MTDIO 2-2, 2-8, 2-18ff 

.MTOPD 1-7, 2-2f, 2-Sf 

Multiprocessor Communications Adapter (MCA) 

1-6, 2-4f, 2-17, 
Chapter 5, 6-6, B-7, B-10 



System call 

descriptions Chapter 2, Chapter 4 

format l-3ff, l-9f 

equivalence 1-3, 1-5 

list 2-2 
system generation (see RTOSGEN) 



NMAX 1-3, 2-23f 
no-ops 1-10 



.OPEN 2-2f, 2-4f 



panics 6-3 
.PCHAR 2-2, 2-22 
power fail 4-4f, B-8 
.PRI 3-1, 3-5, D-lf 
.PTBL 6-2, 6-6f 



.QTBL 6-2, 6-6f 
QTY l-7f, 6-2, 6-6f 



Task 

Concepts 1-1, Chapter 3 
format l-3ff, l-9f 
identification (see .TIDR, . 
.TASK) 
scheduler l-2f 
states 1-2 
status (see . IDST) 
s ync hronizati on 1-3 

.TASK 1-2, 3-1, 3-6f, D-l 

TBOOT 1-11, B-17f 

TCB 1-lff, Chapter 3, 6-lf, 6' 

Teletype commands 2-22f 



TIDK, .TIDP, .TIDS, 



.TIDK 

.TIDP 

.TIDR 

.TIDS 

TLINK 

. TSA VE 



1-2, 3-7 
3-1, 3-7f 
1-2, 3-lf, 3-8 
1-2, 3-lf, 3-8 
6-2f 
6-2f 



.RDB 1-4, 2-2f, 2-10 

.RDL 2-2f, 2-llff 

.RDS 2-2f, 2-12f 

.REC 3-1, 3-5f, 4-2 

.RESET 2-2f, 2-7 

RLOC 6-2f 

.RLSE 1-6, 2-2f, 2-9f 

RSCHED 6-2f 

.RTN 2-2, 2-25 

RTOS 

device support l-5f 
organization Chapter 6 
parameters 1-4, Appendix C 

RTOSGEN 2-1, 4-lf, 6-1, Appendix B, D-5 

.RUCLK 2-2, 2-30 



.UCEX 2-30, 3-1 

.UIEX 3-1, 4-2f 

.UPEX 3-1, 4-5 

User File Pointers Table (. UFPT) 6-2, 6-6 

User interrupts Chapter 4 

User Status Table (UST) 6-2, 6-4 

USP 6-2f 

USTP 6-2 



.WCHAR 2-2, 2-23, 6- 
.WRB 1-4, 2-2f, 2-16 
,WRL 2-2f, 2-16f 
.WRS 2-2f, 2-17f 



SCHED 6-2f 

.SDAY 2-2, 2-27 

sequential I/O 2-3 

.SMSK 3-1, 4-3 

standard device table (see . CHTB) 

.STOD 2-2, 2-28 

.SUSP 1-2, 3-1, 3-6 

.SYS, 6-lf 



.XMT 1-3, 3-1, 3-9 
.XMTW 1-3, 3-1, 3-4, 3- 
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